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1.  Scope. 

1.1  Identification. 

Airnet  Digital  Message  Communications  Console  CSO. 

1.2  S3rstem  overview. 

The  AIRNET  system  is  a  network  of  simulators  to  help  to  teach  Army 
aviation  crews  and  battlefield  support  personnel  to  fight  in  a  combined  arms 
battlefield  enviroiunent. 

The  AIRNET  Digital  Message  Communications  Console  (DMCC)  provides  a 
capability  for  pre>formatted  and  free  text  digital  messaging  between 
simulation  entities  which  are  internal  and  external  to  the  AIRI^T  network. 

The  DMCC  software  is  a  multi-ttireaded,  X-windows  client/server  application 
suite. 

The  DMCC  software  contains  a  custom  protocol  for  commimications  in  the 
context  of  the  SIMNET  and  Draft  DIS  2.0  distributed  simulation  protocols. 
This  protocol  is  fully  interoperable  across  the  SIMNET/DIS  2.0  Protocol 
Translator  Gateway. 

The  DMCC  uses  a  graphical  user  interface  to  emulate  vehicle  crew  station  • 
soldier  machine  interfaces. 

The  Digital  Message  Communications  Console  allows  transmission, 
reception,  and  storage  of,  and  access  to,  pre-formatted  and  free  text  tactical 
messages  between  ground  support.  Tactical  Operations  Centers,  Fire  Support 
Elements,  and  manned  vehide  simulators,  via  the  SIMNET  and  DB 
simulation  networks. 

The  DMCC  software  is  platformed  on  a  Sim  Microsystems  Sparc-10 
workstation  running  SunOS,  Sun  Microsystems  Software's  implementation 
of  the  UNIX  operating  system.  The  runtime  environment  indudes  Version 
11  of  the  X-Windows  windowing  system  and  OSF  Motif  version  1.1  graphical 
user  interface. 

Up  to  8  Wyse  X-terminals  may  be  connected  to  the  workstation  via  the  DMCC 
dedicated  Ethernet  local  area  network.  Multiple  DMCC  client  executables  may 
be  operational  concurrently  under  die  X  client/server  model. 

DMCC  client  processes  run  on  the  Sun  hardware.  Tocal  client"  operation  is 
not  used  in  this  implementation. 
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The  following  diagram  shows  the  top-level  architecture  of  the  Digital 
Message  Communications  Console  System. 


Wortotaaon  I 


ONE  PER  WORKSTATION  ONE  PER  MESSAOE  ENTITY 


Figiire  1  DMCS  Software  Architecture 

The  Receive  process  monitors  the  Ethernet  for  incoming  messages  and 
informs  the  Message  Server  of  their  arrival. 

The  Message  Server  checks  the  message  to  see  if  it  is  addressed  to  any  of  the 
resident  DMCC  X-client  applications.  If  the  message  is  addressed  to  one  or 
more  of  the  DMCC  X-client  applications,  then  the  Message  Server  places  the 
message  in  Shared  Memory  and  informs  the  affected  DMCC  X-dient 
applications  of  its  location  through  a  message  queue  which  is  monitored  by 
tl^  Client  Child  processes. 

The  Client  Child  processes  are  spawned  at  logon  by  the  X-Client  processes  and 
wait  for  indication  of  incoming  messages  addressed  to  it's  parent.  The  Client 
Child  processes  then  inform  tlw  Client  of  the  message  arrival  through  a  pipe. 

Th  DMCC  X-Client  process  is  instantiated  for  each  DMCC  entity  active  in  the 
workstation.  The  DMCC  X-Client  process  contains  the  message  queue,  user 
interface,  and  message  preparation  and  dispatch  software.  The  X-Qi^t  also 
contains  ths  software  which  allows  the  user  to  set  up  addresses  to  which  foe 
user  wishes  to  transmit  messages,  groups  to  which  the  user  wishes  to  receive 
messages,  and  locations  which  are  referred  to  in  creating  messages  for 
transmission. 

The  DMCC  X-Oient  software  has  windows  for  six  different  purposes, 
including: 
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(1)  Logon  and  Setup 

(2)  Message  Queue  Access 

(3)  Message  Access/Deletion 

(4)  Message  Retrieval 

(5)  Message  Forwarding 

(6)  Report  Preparation  and  Transmission 

Each  instantiation  of  the  DMCC  maintains  a  list  of  people  or  teams  to  whom 
it  can  send  messages  called  the  Address  List  The  user  sets  up  the  list  of 
addresses  prior  to  the  start  of  the  exercise,  in  order  to  quickly  send  messages 
during  the  exercise.  He  may  change  die  list  during  die  exercise,  but  normally 
he  would  not  want  to  do  this. 

For  example,  the  user  may  want  to  be  able  to  send  messages  during  die 
exercise  to  his  battalion  cemunander,  his  wing  man,  the  Fire  Support 
Element,  etc.  The  OPORDS  for  his  mission  include  this  list.  He  will 
probably  want  to  enter  their  CEOIs  (call  signs)  in  the  Address  List. 

Groups  are  collections  of  DMCC  simulation  entities.  For  example,  several 
entities  may  be  members  of  the  same  team,  say  TEAM  A.  If  they  wish  to 
receive  messages  transmitted  to  TEAM  A,  they  must  tell  their  DMCCs  to 
receive  messages  addressed  to  that  group.  Each  DMCC  allows  its  operator  to 
be  a  member  of  up  to  seven  groups. 

The  following  figure  details  the  nature  of  the  instantiated-client 
configuration  in  the  context  of  a  X-terminal  client  server  environment 
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Figure  2  DMCC  X-windows  Client  Server  Environment 


13  Document  overview. 

This  document  describes  the  system  design  of  the  Digital  Message 
Communications  Console  CSQ.  It  oudines  the  structure  and  composition  of 
the  CSO  sub-functions  (CSC's  and  CSLTs)  and  provides  a  detailed  description 
of  each. 

Section  2  describes  the  documents  referenced  in  this  specification. 

Section  3  outlines  the  preliminary  design  overview  of  the  CSCI,  and  a 
description  of  each  CSC's  purpose. 

Section  4  describes  the  detailed  design  of  each  CSC. 

Section  5  provides  a  detailed  breakdown  of  aU  data  elements  defined  for  each 
CSC  and  for  each  associated  CSU. 

Section  6  provides  a  data  file  cross  reference  to  aid  in  locating  functions. 
Sections  7  and  8  provide  requirements  and  general  design  notes. 
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Section  9  contains  structure  charts  for  the  overall  DMCC  CSQ  and  its 
ounponent  CSCs. 

Section  10  details  the  datastructures. 

Section  11  contains  state  transition  diagrams  for  tihe  various  omcurrent 
process  CSCs  in  the  DMCC  CSCL 

Section  12  contains  diagrams  of  the  Protocol  Data  Units  used  by  the  Digital 
Message  Ccmununications  Console  to  send  and  receive  digital  messages. 

Section  13  covers  the  Functional  Tests  used  to  verify  proper  operation  of  die 
DMCC  software. 
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2.  Referenced  and  Relevant  documents. 

The  following  documents  of  the  exact  issue  shown  form  a  part  of  this 
specification  to  the  extent  specified  herein.  In  the  event  of  conflict  between 
the  documents  referenced  herein  and  the  contents  of  this  specification,  the 
contents  of  this  spedflcation  shall  be  considered  a  superseding  requirement. 


2.1  Government  documents. 
SPEanCATIONS: 

None. 

STANDARDS: 


DI-MISC-80711,  Scientific  and  Technical  Reports. 

The  SIMNET  Network  and  Protocols.  Report  No.  7627,  Arthur  R  Pope; 
Prepared  for  DARPA  by  Bolt,  Barenek  and  Newman,  Inc.  June  1991. 


IST-CR-92-12 


Military  Standard;  Draft  PIS  2.0:  Protocol  Data  Units  for  Entity  Information 
and  Entity  Interaction  in  a  Distributed  Interactive  Simulation.  Institute 
for  Simulation  and  Trainii^  12424  Research  Parkway,  Suite  300, 
Orlando,  Florida,  September  4, 1992 

2.2  Non-Government  documents. 


Rotary  Wmg.Airgaft  A 

Statement  of  Woik«-Aprii  6m  199Z 


iel  and  Weapons  Model  Conversion 


Software  Requirements  &  Interface  Specification  for  the  AIRNET  MCC 
Comanche  Support  and  Digital  Message/Communications  Upgrade. 


System  Specification  for  the  RWA  AIRNET  Aeromodel  and  Weapons 
Conversion.  LORAL  Western  Development  Labs,  3200  Zanker  Road, 
POBox  49041,  San  Jose,  California,  WDL/TR-92-003011,  June  5, 1992. 


The  X  Window  System;  Programming  and  AppUcations  with  Xt.  OSP/Motif® 
editir  ■  Douglas  A.  Young,  Hewlett-Packard  Laboratories,  Palo  Alto, 
Calif  ia,  Prentice  Hall,  En^ewood  Cliffs,  New  Jersey,  1990 
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The  Motif®  Proyramminy  Manual  for  OSF/Motif  version  1.1.  volumes  1  -  6. 
rrhe  Definitive  Guides  to  the  X-Window  System)  Dan  Heller,  O'Reilly 
&  Associates,  Inc.,  July  1992. 


OSF/Motif®  Programmer's  Reference.  Release  1.1.  Open  Software 
Foundation,  Prentice  Hall,  Englewood  Clifte,  New  Jersey  1991 

Builders  Xcessory  User's  Guide.  Version  2.0.  Integrated  Computer  Solutions, 
Incorporated,  201  Broadway,  Cambridge,  Ma^chusetts,  1991. 


Informarion  technology-Local  ^d  m^politan  area  networks-Part  3: 

Carrier  sense  multiple  access  with  collision  detection  fCSMA/CD>  access 

method  and  physical  layer  spedfications.  International  Standard  ISO/IEC 
8802-3  : 1992  ANSI/IEE  Std  8023, 1992  Edition,  The  Institute  of  Electronics 
and  Electronics  Engineers,  Inc. 


The  Ethernet.  Physical  and  Data  Link  Layer  Specifications.  Version  2.0.  Digital 
Equipment  Corporation,  Intel  Corporation,  and  Xerox  Corporation,  1982. 


A  Standard  for  the  Transmission  of  IP  Datagram  over  IEEE  802  Networks 
(Internet  and  Address  Resolution  Protocol  on  IEEE  802  Networks)  Network 
Working  Group,  Request  for  comments(RFC);  1042  J.  Postel  and  J.  Reynolds, 
ISI,  February  1988. 
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3.  PreUmiiuiy  design. 

3.1  CSQ  overview. 

The  DMCC  Computer  Software  Configuration  Item  includes  all  the  software 
executeables  to  implement  the  Digital  Message  Communications  Console.  It 
includes  CSC's  for  SIMNET  commiinications;  message  routing;  user  interface, 
message  storage,  access,  retrieval,  preparation,  and  transmission;  and  message 
arrival  notification. 

Multiple  X-client  and  X-client  child  processes  may  be  instantiated  to  serve 
multiple  X-terminal  simulation  entities. 

The  design  of  the  Digital  Message  Communications  Console  software  is 
detailed  in  this  document. 
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3.1.1  CSO  architecture. 

The  structure  charts  shown  in  Appendix  A  outline  the  detailed 
orgaiuzational  structure  of  the  CSQ. 

The  following  top  level  structure  chart  outlines  the  top  level  structure  of  the 
DMCCCSO: 


Figure  3  Top  Level  DMCC  CSCs 

The  list  of  Computer  Software  Components  (CSCs)  and  sub-level  CSCs 
following  this  paragraph  includes  a  siunmary  of  the  purpose  of  each,  the 
inter-CSC  relationships  and  a  CSC-to-CSC  interface  summary. 
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Table  1.  CSC  Summary  table 


CSC 

Source  File 

Description/Interface  Summary 

dms 

dmsx 

DESOUFTION:  The  dms  function  manages  the  distiibuticMt 
of  messages  to  DMCC  op^ ators.  It  receives  a  login  message 
from  each  operator,  whidi  contains  the  message 

CEOIs/Groups  that  should  be  sent  to  Une  operator. 

INPUTS: 

1.  DMCC  messages 

2.  Login  requests 

3.  Logout  requests 

4.  CEOI/Gimip  updates 

OUTPUTS: 

1.  Incoming  shared  memory  segment 

2.  FanHJut  message  queue 

3.  Outgoii^  message  queue 

4.  Digital  Message  arrival  notifications 

build  pdu 

bldpdux 

DESCRIPTION:  The  build  pdu  function  provides  the  X* 
window  operator  interface  the  means  to  construct  Digital 
Messages  and  send  them  out  to  die  SIMNET  Ediemet  process. 

INPUTS: 

1.  Digital  Message  data  items 

OUTPUTS: 

1.  Digital  Messages 

2. Drc 

ipc 

dmslibx 

DESCRIPTION:  The  ipc  function  provides  an  interface  for  the 
X'window  process,  and  die  SIMb^  Ediemet  interface 
processes  to  send  and  receive  DMCC  messages.  It  initializes 
die  X'window  diild  process  that  receives  new  Digital 

Message  arrival  notifications  from  die  dms  process.  The  child 
process  reads  the  new  messages  from  Glared  memory  and 
passes  diem  to  the  X-window  parent  process  via  a  pipe. 

INPUTS: 

1.  Digital  Message  from  SIMNET  intertoce  process 

2.  EMgital  Message  data  items  from  X-window  operator 
interface  process 

3.  CECX/Groups 

OUTPUTS: 

1.  Digital  Message  arrival  notifications 

2.  Digital  Messages 

3.  Login  requests 

4.  Logout  requests 
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Address  list 
screen  creation 


addrUsLc 


The  MMI  function  allows  the 
create,  reed  and  send  mwsagrw 

INPUTS: 

1.  EHklGC  mesaagea 

2.  Formatted  messages  for  reading 

OUTPUTS: 

1.  Loginrequesis 

2.  Logout  requests 

3.  CB^/Group  updates 

4.  DMCC  messages 

5.  Dioital  Messase  data  items 


DESCRIPTION:  Creates  Address  List  Screen 
INPUTS:  None 
OUTPUTS:  None 


user  to  logon. 


Address  list  addrListCBx  DESCRIPTION:  Address  List  Callbacks 
screen  callbacks 

INPUTS:  None 
OUTPUTS:  None 


Cans<^  screen  consolex 
creation 


DESCRIPTION:  Creates  Console  Screen 


INPUTS:  None 


OUTPUTS:  None 


Console  screen  consoleCB.c  DESCRIPTION:  Omsole  Screen  callbadss 
callbacks 

INPUTS:  None 
OUTPUTS:  None 


Form  trim 
drawing 


fbrmTtiinx  DESCRIPTION:  Crop  forms 
INPUTS:  None 


OUTPUTS:  None 
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Bee  text  report 
screen  aeatkm 


Free  text  report 
screen  callbacks 


GetDMCC 

messages 


Group  list  screen 
creation 


Group  list  screen 
callbacks 


List  widget 
utilities 


Location  list 
screen  creation 


freeTxtc  DESCRIPTION:  Creates  free  text  msg  prep  screen 
INPUTS:  None 


OUTPUTS:  None 


freeTxtCB.c  DESCRIPTION:  Free  text  report  callbacks 
INPUTS:  None 


OUTPUTS:  None 


DESCRIPTION:  Retrieves  messages  from  shared  mem 
INPUTS:  None 


OUTPUTS:  None 


groupListc  DESCRIPTION:  Creates  group  list  screen 
INPUTS:  None 


OUTPUTS:  None 


gtoupListCB.c  DESCRIPTION:  Group  list  screen  callbacks 
INPUTS:  None 


OUTPUTS:  None 


listUtilities.c  DESCRIPTION:  List  widget  functionality 
INPUTS:  None 


OUTTUTS:  None 


locListx 


DESCRIPTION:  Creates  location  list  screen 


INPUTS:  None 
OUTPUTS:  None 
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Location  list 
screen  callbacks 

locListCB.c 

DESCRIPnON:  Locatkm  List  Callbacks 

INPUTS:  None 

OUTPUTS:  None 

Logon  screen 
creation 

logonx 

DESCRIPTION:  Creates  Logon  screen 

INPUTS:  None 

OUTPUTS:  None 

Logon  screen 
callbacks 

logonCBx 

DESCRIPTION:  Logon  screen  callbacks 

INPUTS:  None 

OUTPUTS:  None 

Main 

mainx 

DESCRIPTION:  Main 

INPUTS:  None 

OUTPUTS:  None 

MovondTMI 
screen  callbacks 

movcmdTniL 

calLc 

DESCRIPTION:  MOVCMD  screen  callbacks 

INPUTS:  None 

OUTPUTS:  None 

MbvcmdTMI 
screen  create 

movcmdTinL 

createx 

DESCRIPTION:  Creates  MOVCMD  screen 

INPUTS:  None 

OUTPUTS:  None 

Movcmd  screen 
callbacks 

movcmd.call. 

c 

DESCRIPTION:  MOVCMD  screen  callbacks 

INPUTS:  None 

OUTPUTS:  None 
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Movandsomn 

create 

movcmd_crea 

te.c 

DESCRIPnON:  Creates  MOVDMD  screen 

INPUTS:  None 

OUTPUTSd^one 

Messagebox 
screen  create 

msglx 

DESCRIPTION:  Creates  Message  Box  Screen 

INPUTS:  None 

OUTPUTS:  None 

Messagebox 
screen  callbacks 

msglCBx 

DESCRIPTION:  Message  Box  Screen  Callbacks 

INPUTS:  None 

OUTPUTS:  None 

Message  read 
screeen  create 

msgReadx 

DESCRIPTION:  Creates  READ  screen 

INPUTS:  None 

OUTPUTS:  None 

Message  read 
screen  callbacks 

msgReadCBx 

DESCRIPTICM:  Read  screen  callbacks 

INPUTS:  None 

OUTPUTS:  None 

MTOTMI  screen 
callbacks 

mtoTmi_call. 

c 

DESCRIPTION:  MTO  screen  caUbacks 

INPUTS:  None 

OUTPUTS:  None 

MTOTMI  screen 
create 

mtoTmLcreat 

ex 

DESCRIPTION:  Creates  MTO  screen 

INPUTS:  None 

OUTPUTS:  None 
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MID  screen 
callbacks 

mto_call.c 

DESCRIFT04:  MOT  screen  calibacks 

INPUTS:  None 

OUTPUTS:  None 

MID  screen 
create 

mto.create.c 

DESCRIPTION:  Creates  MID  screen 

INPUTS:  None 

OUTPUTS:  None 

Popup  messages 

pi^pMessag 

ex 

INSCRIPTION:  Executes  p(^p  messages 

INPUTS:  None 

OUTPUTS:  None 

Rep<^  screen 
create 

reportc 

DESCRIPTICM:  Creates  Reports  screen 

INPUTS:  None 

OUTPUTS:  None 

Reports  screen 
callback 

reportCBx 

DESCRIPTION:  Reports  screen  callbacks 

INPUTS:  None 

OUTPUTS:  None 

Request  TMI 

reqtTini_call. 

DESCRIPTION:  Request  screen  caUbac  ks 

screen  callbacks 

c 

INPUTS:  None 

OUTPUTS:  None 

Request  TMI 

reqtTini_crea 

DESCRIPTION:  Creates  Request  screen  TMIs 

screen  create 

tex 

INPUTS:  None 

OUTPUTS;  None 
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Request  screen 
calltMicks 

1 

reqt_call.c 

DESCRIPnCM:  Request  screen  qllbacks 

INPUTS:  None 

OUTPUTS:  None 

Request  screen 
create 

reqt_cteate.c 

DESCRIPnON:  Creates  Request  screen 

INPUTS:  None 

OUTPUTS:  None 

Shot  TMI  screen 

shotTmi.call 

DESCRIPTION:  Shot  TMI  screen  callbacks 

callbacks 

.c 

INPUTS:  None 

OUTPUTS:  None 

Slot  TMI  screen 

shotTmLcrea 

DESCRIPTIC»4:  Creates  Shot  screen  TMIs 

create 

te.c 

INPUTS:  None 

OUTPUTS:  None 

Shot  screen 

shot_call.c 

DESCRIPTION:  Shot  screen  callbacks 

callbacks 

INPUTS:  None 

OUTPUTS:  None 

Shot  screen 
create 

shot_create.c 

DESCRIPTION:  Creates  Shot  screen 

INPUTS:  None 

OUTPUTS:  None 

Splash  TMI 

splashTmLc 

DESCRIPTION:  Splash  TMI  screen  callbacks 

screen  callbacks 

all.c 

INPUTS:  None 

OUTPUTS:  None 
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Splash  tMI 
screen  create 

splashTini.cr 

eatex 

DESCRim^:  Creates  Splash  screen 

INPUTS:  None 

OUTPUTS:  None 

^lash  screen 
callbacks 

splash_call.c 

DESCRIPTICM:  Splash  screen  callbacks 

INPUTS:  None 

OUTPUTS:  None 

Splash  screen 
create 

splash_creat 

ex 

DESCRIPTION:  Creates  splash  screen 

INPUTS:  None 

OUTPUTS:  None 

Spot  TMI  screen 
cutbacks 

spotTmi.call. 

c 

DESCRIPTION:  Spot  TMI  screen  callbacks 

INPUTS:  None 

OUTPUTS:  None 

Spot  TMI  screen 
create 

spotTini_crea 

tex 

DESCRIPTION:  Creates  spot  screen  TMIs 

INPUTS:  None 

OUTPUTS:  None 

Spot  screen 
callbacks 

spot_caUx 

DESCRIPTION:  ^wt  screen  caUbacks 

INPUTS:  None 

OUTPUTS:  None 

^x}t  screens 
create 

spot_createx 

DESCRIPTION:  Creates  Spot  screen 

INPUTS:  None 

OUTPUTS:  None 

Page  17 


Document  ADST/WDL/TR~93-003036  March  31, 1993 


Mainsoecn 

create 

sysMainx 

DESCRIPTION:  Creates  SYS  MAIN  screen 

INPUTS:  None 

OUTPUTS:  None 

Main  screen 
callbacks 

sysMainCBx 

DESCRIPTION:  Main  screen  callbacks 

INPUTS:  None 

OUlTUTS:None 

MMI  utilities 

util.c 

DESCRIPTION:  Various  Man  Mad^ne  Interface  Utilities 

INPUTS:  Various  (See  section  4) 

OUTPUTS:  Various  (See  section  4) 

3.1^  System  states  and  modes. 

The  DMCC  software  consists  of  five  concurrent  process  types,  to  receive,  route 
and  transnat  ethemet  Protocol  Data  Units,  and  the  X<Client  and  X-Qient 
Child  processes.  All  of  these  process  types,  witti  the  exception  of  the  X-Qient, 
are  modeless,  that  is,  they  wait  for  a  single  type  of  event  and  then  handle  that 
event  in  a  single-threaded,  one  shot  manner. 

The  X-Client  Process,  on  the  other  hand,  has  many  states  or  modes,  and 
actions  which  this  process  takes  in  response  to  events  depeiul  on  many 
factors.  The  basic  modes  or  states  which  toe  DMCC  Client  Process  can  exhibit 
are  closely  bound  to  the  concept  of  an  "active”  X-Window. 

The  X-Client  Pro^ss  State  Event  Matrix  is  shown  in  Appendix  C.  This 
diagram  shows  actions  and  transitions  from  various  window  states  bound  to 
event  flags  representix^  operator  intervention,  such  as  clicking  on  a  button 
region  of  a  wi^ow.  Each  cell  shows  what  actions  are  taken  as  a  result  of  an 
event  followed  by  a  semicolon  0)  character,  which  is  followed  by  an 
indication  of  the  next  window  to  transition  to  (make  active),  if  any.  The  top 
row  is  a  list  of  the  window  events  and  the  left  column  is  a  list  of  window 
states. 
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3.1.3  Memory  and  processing  time  allocation. 

Because  the  Digital  Message  Communication  System  is  a  near-real-time 
messaging  system,  there  are  no  hard  requirements  for  processing  time,  other 
than  to  respond  fast  enough  such  that  seamless  "realistic**  simulation  is 
maintained..  The  Sparc-10  workstation  platform  provides  processing  speed 
(56,000,000  instructions  per  second)  an  order  of  magnitude  in  excess  of  that 
required  for  timely  user  interface  activity  and  message  handlmg. 

The  following  table  depicts  the  rough-order-of-magnitude,  worst  case 
memory  requirements  for  the  DMCC  software  suite: 

Table  2  Memory  Requirements 


Procesa 

Rough  Order  Of  Magnitude, 
Worst  Case 

Memorv  Reoui remen t 

System 

16  MB 

8  X  window  manaaers 

12  MB 

dms  orocess 

1  MB 

8  Client  Processes 

12  MB 

8  Client  Children 

1  MB 

Ethernet  Receive 

1  MB 

Ethernet  Transmit 

1  MB 

Total 

44  MB 
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3JE  CSa  design  description 

The  DMCC  CSCI  consists  of  five  concurrent  processes  to  receive  etlwrnet 
messages  (Receive),  rout  them  to  client  DMCC  entities  (Digital  Message 
Server)  ,  to  transmit  ethemet  messages  (Transmit),  to  handle  user  interface 
and  manage  user  message  queues  (X-Client)  and  to  inform  the  X-Client  of 
message  arrival  (X-Client_Child).  In  a  particular  installation,  only  one 
Transmit,  Receive  and  Digital  Message  Server  process  is  active  at  any  one 
time.  The  X-CUent  and  X-Client  Child  processes  are  instantiated  for  each  of 
the  active  Digital  Message  Communications  Consoles  (X-Tenninals)  active  in 
the  system.  Thus,  for  an  eight  client  system,  a  total  of  nineteen  concurrent 
processes  may  be  active. 


3^1  CSC  dms 

DESCRIPTION:  The  dms  function  manages  the  distribution  of  messages  to 
DMCC  operators.  It  receives  a  login  message  horn  each  operator,  which 
contains  the  message  CEOIs/Groups  that  should  be  sent  to  die  operator. 

The  following  diagram  shows  the  relationship  of  the  digital  message  server  to 
the  other  concurrent  processes  in  the  DMCC  software. 
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Block  Otagram  of  DMCC 
(1(MM2v2) 

(Each  box  oorri^)ond8  to  a  piooaas) 


Figure  4  DMCC  Concurrent  Processes 

Specific  duties  performed  by  the  digital  message  server  are: 

1.  Remove  any  existing  copies  of  shared  memory  segment  and  message 
queues. 

2.  Create  Incoming  shared  memory  segment,  FaivOut  message  queue,  and 
Outgoing  message  queue. 

3.  Process  login  and  logout  requests  from  X-Qient  CSC. 

4.  Store  CEOIs/Groups  reoeiv^  in  login  message  or  newdests  message  from 
X-dientCSC. 

5.  Process  new  DMCC  PDU  arrival  notificatioxts  from  ethemet  CSC. 

6.  Determine  which  operators  should  be  notified  of  the  arrival  of  a  new 
DMCC  PDU  based  on  a  match  between  foe  Target  CEOI  in  the  message/  and 
the  CEOIs/Groups  passed  in  the  login  message  or  newdests  message/  and  the 
exercise  id  contained  in  foe  new  DMCC  PDU  and  the  exercise  that  was  passed 
firom  the  operator  in  the  login  message. 
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7.  Send  kill  signal  via  operating  system  interface  to  the  X-client  child  when  an 
operator  logs-out  and  then  remove  all  notifications  sent  to  operator  in  Fan- 
Out  queue,  and  decrement  'in  use'  (this  is  data  item  "nbr.readers"  in  the 
shared  memory  segment)  flag  for  each  message  in  shared  memory  segment. 

The  following  State  Transition  Diagram  details  the  activity  sequencing  for  the 
digital  message  server: 


FilQiMUMancI 
SharadMon 


OuauMand 

ShaiadMam 

IniTd 


RmkJ  Mmasqs 
OuMja 


Figure  5  CSC  dms  State  Transition  Diagram 


CSC  INTERFACES: 

1.  "shmaddr"  data  item  is  initialized  with  address  of  shared  memory  segment 
Offsets  from  this  address  contain  messages  and  are  passed  to  CSC  client  when 
a  new  message  arrives. 

2.  Data  item  "msgin"  with  flag  msg_type  set  to  MSG.DMAVAIL  is  received 
fi'om  CSC  ethemet  and  contains  notification  of  the  arrival  of  a  new  message, 
and  its  location  in  the  shared  memory  segment 

3.  Data  item  "msgin"  with  flag  msg_type  set  to  ^^SG.DONE  is  received  from 
CSC  client  and  indicates  when  a  message  has  been  read. 
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4.  Data  item  "msgin"  with  flag  msg_type  set  to  MSG_LCXX)UT  is  received 
hrom  CSC  client  aiul  iiuiicates  a  logout 

5.  Data  item  "msgin"  with  flag  msg_type  set  to  MSG_L<XnN  is  received  from 
CSC  client  and  indicates  an  operator  is  loging-in. 

6.  Data  item  "msgin"  with  flag  msg_type  set  to  MSG_NEVVDESTS  is  received 
from  CSC  client  and  indicates  that  the  operators  list  of  CEOIs/Groups  has 
changed. 

7.  Data  item  "msgout"  is  sent  to  CSC  client  when  a  new  message  is  available. 
3^  CSC  build  pdu 

DESCRIPTION:  The  build  pdu  function  provides  the  X-window  operator 
interface  process  the  means  to  construct  Digital  Messages  and  send  them  out 
to  the  SIMNET  Ethernet  interface  process. 

Specific  duties  performed  are: 

1.  Create  the  appropriate  Digital  Message. 

2.  Send  the  message  to  CSC  ethemet. 

3.  Return  the  current  Zulu  DTG. 

4.  Forward  a  received  message  to  another  operator. 

CSC  INTERFACES: 

1.  Data  item  "pdu"  is  sent  to  the  CSC  ethemet  via  the  Outgoing  queue 

2.  Each  PDU  builder  CSU  has  if  s  own  interface  which  includes  those  unique 
data  items  needed  to  build  the  PDU.  These  are:  TBD 

3.  Data  item  "dtg"  is  returned  to  caller  CSC  client  containing  Zulu  date-time 
group. 

4.  Data  item  "dmcc_timezone_offset_g"  contains  the  localtime  to  zulu  time 
difference  in  minutes,  and  is  received  from  CSC  client  via  the  file 
"/tmp/dmcc_timezone_offset". 

3^3  CSC  ipc 

DESCRIPTION:  The  ipc  function  provides  an  interface  for  the  X-window 
process,  and  the  SIMNET  Ethemet  interface  processes  to  send  and  receive 
DMCC  messages.  It  initializes  the  X-window  client  child  process  that  receives 
new  Digital  Message  arrival  notifications  from  the  dms  process.  The  child 
process  reads  the  new  messages  from  shared  memory  and  passes  them  to  the 
X-window  parent  process  via  a  pipe. 

Specific  duties  performed  are: 

1.  Create  a  'child'  process  of  CSC  client  that  is  used  to  communicate  with  CSC 
dms. 

2.  Attach  to  shared  memory  segment  and  Fan-Out  queue  for  CSC  client 
'child'. 

3.  Attach  to  Outgoing  queue  for  CSC  dmcc  'parenf . 
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4.  Attach  to  Fan-Out  queue  for  CSC  dmcc_sim_tx. 

5.  Send  login  and  logout  message  to  CSC  dms. 

6.  Put  a  message  in  the  Outgoing  queue. 

7.  Receive  a  message  horn  the  Fan-Out  queue  containing  notification  of  the 
arrival  of  a  new  DMCC  PDU. 

8.  Fmd  the  address  of  a  free  record  in  the  shared  memory  segm^t 

9.  Copy  a  DMCC  PDU  into  the  shared  memory  segment. 

10.  Seitd  updated  lists  of  operator  CEOFs/Group's  from  CSC  dmcc  to  CSC  dms. 

11.  Read  the  pipe  between  the  X-client  process  and  die  child  process. 

12.  Return  the  exerdse  id  of  die  operator  to  a  caller. 

13.  Return  the  operators  name  to  the  caller. 

CSC  INTERFACES: 

1.  Data  item  "mode"  received  from  CSC's  client  and  ethemet. 

2.  Data  item  "buf"  received  from  CSC  client . 

3.  Data  item  "buflen"  received  from  CSC  client . 

4.  Data  item  '1:>uf"  passed  to  CSC  client . 

5.  Data  item  "getfreerecord"  passed  to  CSC  ethemet. 

6.  Data  item  "new_dm_address"  is  received  from  CSC  ethemet. 

7.  Data  item  'l5uf"  is  received  from  CSC  ethemet 

8.  Data  item  "buflen"  received  from  CSC  ediemet. 

9.  Data  item  "dests"  received  from  CSC  ethemet. 

10.  Data  item  "exid"  received  from  CSC  ediemet. 

11.  Data  item  "dests"  received  from  CSC  client . 

12.  Data  item  "exid"  received  from  CSC  client . 

13.  Data  item  "ceoi"  received  from  CSC  client . 

14.  Data  item  "p"  received  from  CSC  client . 

15.  Data  item  "pdu"  received  from  CSC  client . 

16.  Data  item  "dms^etexid"  passed  to  CSC  build  pdu. 

17.  Data  item  "dms_getopemame"  passed  to  CSC  build  pdu. 

18.  Data  item  "dmslogin"  passed  to  CSC  client . 

The  following  diagram  depicts  the  state  transitions  of  the  Client  Child 
process: 
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Figxire  6  Client  Child  State  Transition  Diagram 
3.2.4  CSC  ethemet 

DESCRIPTION:  The  ethemet  CSC  contains  the  functionality  for  receiving 
DMCC  PDUs  from  and  sending  them  to  the  SIMNET  ediemet  network.  It 
consists  of  two  concurrent  processes/  one  for  transmission  and  one  for 
reception  of  messages. 

Specific  duties  performed  are: 

1.  Set  up  receive  and  transmit  queues  for  die  incoming  and  outgoing 
messages. 

2.  P^orm  encode/decode  actions  on  tlw  messages  and 
completeness  checks  on  the  contents  of  those  messages. 


Page  25 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


CSC  INTERFACES: 

1.  Name  of  computer  interface  is  passed  to  dmcc_sim_rx  and  dmcc_sim_tx 
via  operator  input: 

dmcc_sim_rx  Ethernet  ^interface _name 
dmcc_sim_tx  Ethernet ^interface_name 


3JL4.1  Sub-level  CSC  dmcc_sim_fx  process 

DESCRIPTION:  The  dmcc_sim_rx  function  initializes  the  message  queue, 
invokes  functions  to  initialize  ethernet  interface  to  receive  messages  in 
promiscuous  mode  on  Ethernet,  to  read  in  message,  to  timestamp  the  input 
message,  to  validate  the  SNAP  and  association  layer  headers  of  the  input 
message,  to  validate  exercise  identification  number,  to  check  for  valid 
association  pdu  format,  to  split  up  the  input  message  packet  into  individual 
association  PDUs  if  applicable,  and  to  copy  parsed/checked  message  onto  CSC 
dms  shared  memory. 

Specific  duties  performed  are: 

1.  get  ethernet  interface  name  from  command  line  argument  and  copy  it 
onto  the  global  variable  SIM_interface_name. 

2.  initialize  message  queue  with  dmsinit(). 

3.  invoke  SIM_rx_netif(). 

CSC  INTERFACES: 

1.  on  line  command  argument  "leO"  or  Tel”  is  the  interface  name  and  is 
copied  onto  the  global  variable  SIM.interface.name. 

2,  Data  Item"DMS_ENET_TRANSMrr'  is  passed  to  CSU  dmsinit. 

3,2.4.2  Sub-level  CSC  dmcc.sim.tx 

DESCRIPTION:  The  dmcc  sim.tx  function  controls  the  flow  of  messages 
fiom  the  DMCC  onto  the  Ethernet.  It  parses  the  interface  name  from  on-line 
command  argument  and  invokes  functions  to  read  pdu  from  initialized 
message  queue,  to  add  association  layer  and  padding  bytes  to  the  input 
message  if  applicable,  to  initialize  ethernet  interface  to  send  messages  onto 
the  network  as  broadcast  messages,  to  set  the  IEEE  8023  MAC  sublayer  frame 
control  header  with  the  destination  broadcast  address,  to  fill  the  IEEE  802.2 
LLC  sublayer  frame  control  header,  to  add  padding  bytes  if  necessary,  and  to 
output  message  onto  Ethernet. 

Specific  duties  performed  are; 

1.  Initialize  message  queues  for  each  of  the  input  Ethernet  interface  names. 

2.  Zero  the  message  buffer  and  read  a  new  message  into  the  buffer. 

3.  Send  the  message  to  die  pdu  encode  function. 
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CSC  INTERFACES: 

1.  on  line  command  argument  "leO"  or  "lei"  is  the  interface  name  and  is 
copied  onto  the  global  variable  SIM_interface_name. 

2.  Data  item"DMS_ENET_TRANSMIT"  is  passed  to  CSU  dmsinit 

3.  Data  item  "input  buffer-  buff"  is  passed  to  CSU  bzero. 

4.  Data  item  "input  buffer-buff"  is  passed  to  CSU  dms.recvdm. 

5.  Data  items  "NEW_ALPDU-pdu  sequence",  "input  buffer-buff"  and 
"number  bytes  read-nbyte_read"  passes  to  C^  ALPDU_SIM_encode. 

3,2.5  CSCdient 

DESCRIPTION:  The  client  function  provides  the  interface  with  the  user, 
allowing  the  user  to  create  and  read  Digital  Messages. 

Spedffc  duties  performed  are: 

1.  Allow  the  user  to  login  and  send  the  login  information  to  the  dms  CSC. 

2.  Allow  the  user  to  enter  CEOI/Group  information  and  send  it  to  the  dms 
CSC. 

3.  Receive  PDU  from  the  dms  CSC.  The  client  will  then  send  the  PDU  to  the 
PDU  decode  CSC  for  translation  to  a  user  readable  form.  This  message  is  then 
placed  in  a  global  structure  and  an  entry  is  added  to  the  MSGl  screen  and  the 
New  Mail  icon  is  updated. 

4.  Allows  the  user  to  read  the  message. 

5.  Allows  the  user  to  reply  to  the  message. 

6.  Allows  the  user  to  forward  the  message. 

7.  Allows  the  user  to  forward  the  message  and  include  an  additional  message. 

8.  Allows  the  user  to  delete  the  message  from  the  message  queue. 

9.  Allows  the  user  to  compose  a  Digital  Message  and  send  it  either  as  an 
urgent  or  a  routine  message. 

CSC  INTERFACES: 

1.  Data  item  "readBuf"  is  received  from  dms  CSC  via  a  pipe  widi  the  label 
pipeFD.  This  data  item  is  then  placed  in  the  global  data  item  "messages"  as 
the  "pdu"  field  for  use  later. 

2.  The  "pdu"  field  of  the  data  item  "messages"  is  passed  to  pdu_decode. 

3.  The  data  item  "msgBuf"  is  returned  from  the  call  to  pdu.decode. 

4.  Data  item  "dmcc_timezone_offset_g"  contains  the  localtime  to  zulu  time 
difference  in  minutes  and  is  received  from  a  read  of  the  file 
"/tmp/dmcc_timezone_offeet_g". 

5.  The  data  item  "reusePDU"  is  sent  to  the  bldpdu  CSC  through  a  call  to 
fwdpdu. 

6.  The  data  item  "SenderCEOI"  containing  the  name  of  the  sender  of  the 
Digital  Message  is  passed  to  the  bldpdu  C^  through  a  call  to  bldAck.  This  call 
sends  an  acknowledgment  pdu  to  the  sender. 
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7.  Data  items  (TBD)  are  sent  to  the  bldpdu  CSC  via  one  of  the  bldpdu 
functions,  depending  on  what  type  of  Message. 

3^6  CSC  pdu_decode 

DESCRIPTION:  The  pdu  decode  function  decodes  the  input  pdu  based  on  its 
spedhc  message  type  and  returns  the  decoded  message  to  caller.  It  outputs 
error  message  for  unrecognizable  message  type. 

Specific  duties  performed  are: 

1.  Decode  the  input  message  header. 

2.  Decode  the  input  message  based  on  its  message  type. 

3.  Concatenate  the  decoded  message  header  and  body. 

4.  Return  the  decoded  message  to  caller. 

CSC  INTERFACES: 

1.  Data  item  "pdu"  pass-in  to  CSC  pdu.decode. 

2.  Data  item  "pdu"  is  passed  to  the  CSU  pdu_spec_decode  for  decoding  the 
header  information. 

3.  Data  item  "pdu"  is  casted  with  its  specific  message  type  before  passing  to 
the  appropriate  message  decode  function  to  decode  the  message  l^y. 
Possible  message  decode  functions: 

decode_ack_pdu(  (Ack_type  •)  pdu) 
decode_spot_pdu(  (Spot_type  •)  pdu) 
decode_bda.pdu(  (BDA_type  •)  pdu); 
decode_free_text_pdu(  (FreeText^type  •)  pdu) 
decode_gndroute_pdu(  (Recon_type  •)  pdu) 
decode_airroute_pdu(  (Recon_t^>e  *)  pdu) 
decodeJbridge.pdu(  (Recon_ty^  *)  pdu) 
decode_lzpz_pdu(  (Recon_type  *)  pdu) 
decode_bpop_pdu(  (Recon_type  *)  pdu) 
decode_crossing_pdu(  (Recon_type  *)  pdu) 
decode_rep)eat_pdu(  (Artillery_type  *)  pdu) 
decode_cancel_pdu(  (Artillery_type  *)  pdu) 
decode_check_^u(  (ArtUlery^tj^  *)  pdu) 
decode_cno_pdu(  (Artillery_type  *)  pdu) 
decode_shift_pdu(  (Artillery_type  *)  pdu) 
decode_nwmsn_pdu(  (Artillery_type  *)  pdu) 
decode_mto_pdu(  (Ax^lery^type  •)  pdu) 
decode_shot_pdu(  (Artillery_t5rp€  *)  pdu) 
decode_splash_pdu(  (Artillery_type  *)  pdu) 
decode_eom_pdu(  (Artillery_type  *)  pdu) 
decode_status_pdu(  (Status^type  *)  pdu) 
decode.request_pdu(  (Request_type  *)  ^u) 
decode_nbcl_pdu(  (Nrc_type  *)  pdu) 
decode_nbc4_pdu(  (NBC_t^)e  *)  pdu) 
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(iecode_nbc5_pdu(  (NBC_type  *)  pdu) 
decode_iniji_pdu(  (MIJLtype  *)  pdu) 
decode_pirep4xlu(  (POEP.type  •)  pdu) 
decode_dnav_pdu(  (DNAV.type  •)  pdu) 
decode_movcmd.^u(  (Move_type  •)  pdu) 

4.  Data  item  "dmc.buffer"  which  ccmtains  the  decoded  message  header  and 
body  is  being  returned  to  caller. 
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4.  Detailed  design. 

The  following  section  identifies  and  describes  the  relationship  of  each  CSU  to 
it's  calling  The  table  below  provides  a  reference  of  CSU's  and  their 
calling  CSC's. 


Table  3.  CSC/CSU  Cross  Reference  Table. 


CSC 

CSU 

dms 

main 

init_queue 

init_shared_inem 

cmpfixedstr 

trimup 

cleanup.xchild 

build  pdu 

setdtR 

bldAck 

bldFreeText 

bldSpot 

bldMove 

bldMTO 

bldShot 

bldSplash 

fwdpdu 

IHBHHIHHiHilHHH 

ipc 

dmsinit 

dms_senddm 

dms_recvdm 

dms.seekrecoid 

dfns_notify 

dmsnewdests 

dmdoRout 

dmsjsetdm 

dmsjtetexid 

1 

Page  30 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


4.1  CSC  dms. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
dms  CSC  in  terms  of  data  flow  between  the  CSLTs  of  this  CSC  and  identifies 
all  CSU  interfaces  that  are  external  to  the  dms  CSC. 

CSC  dms  satisfies  System  Segment  Specification  requirements  3.2. 1.2.1  and 
3.2.I.2.2. 

The  following  structure  chart  outlines  the  top  level  structure  of  the  dms  CSC. 


Figure  6a  CSC  dms  Structure 
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4.1.1  CSU  main. 

The  main  CSU  is  a  driver  for  the  dms  function,  and  calls  routines  to 
initialize  message  queues  and  shared  memory,  and  then  calls  a  routine  that 
infinitely  waits  for  message  notifications  to  arrive.  The  following  paragraphs 
provide  design  information  for  this  CSU. 

4.1.1.1  CSU  main  design  specification/constraints. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 


4.1.1.2  CSU  main  design. 

The  information  identified  below  represents  the  detailed  design  of  the  main 
CSU. 


a.  Input /output  data  elements. 

INPUTS: 

None 

OUTPUTS:  None 

b.  Local  data  elements. 

None 


c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the  main 
CSU: 

"fanout.qid"  stores  the  id  of  the  Fanout  message  queue, 
"outgoing.qid"  stores  the  id  of  the  Outgoing  queue. 

"shmaddr"  stores  the  address  of  the  shared  memory  segment. 

h.  Logic  flow.  Single  pass. 
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i.  Data  strurturiMt  None 

j.  Local  data  files  or  database.  None 

k.  UmitaHong.  None 

4.1^  CSU  init.queue. 

The  init:_queue  CSU  creates  the  messa^  queues  used  in  the  DMCC.  It  wUl 
first  delete  any  queues  left  from  a  previous  run  of  the  strftware.  The 
following  paragraphs  provide  design  information  for  this  CSU. 

4.1.2.1  CSU  init.queue  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helict^ter  mission  equipment  package. 

4.1.2.2  CSU  init_queue  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
init.queue  CSU. 


a.  Input/output  data  elpmffnts. 

INPUTS: 

"key"  is  a  data  item  ctmtaining  the  operating  system  if  of  the 
queue  to  be  created. 

OUTPUTS:  None. 


b. 


c 

d. 


Local  data  elements. 

"qid"  is  a  data  item  used  to  store  the  id  of  the  created  messa^ 
queue. 


Interrupts  and  signals.  None 
Algorithms.  None 


e.  Error  handling,  logs  an  error  if  the  queues  cannot  be  attached, 
and  returns  1 


f .  Data  conversion.  None 
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g.  Use  of  other  elgmcnts.  Other  elements  that  are  used  by  the 
init.queue  CSU:  None 

h.  Logic  flow.  Single  pass. 

i.  Data  structures-  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.1.3.  CSU  init_shared_mem. 

The  init_shared.mem  CSU  creates  the  shared  memory  segment  used  in  the 
DMCC.  It  will  first  delete  the  segment  if  one  is  left  from  a  previous  run  of  die 
software.  The  following  paragraphs  provide  design  information  for  this  CSU. 

4.1.3.1  CSU  init_sharcd_mem  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  .helicopter  mission  equipment  package. 

4.I.3Jt  CSU  init.shared_mem  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
init_shared_mem  CSU. 


a.  Input/output  data  elements. 

INPUTS; 

"key"  is  the  operating  system  id  for  the  shared  memory  segment. 

"size"  is  the  length  in  bytes  of  the  segment 

OUTPUTS: 

"init.shared.mem"  is  the  address  of  the  shared  memory 
segment. 


b. 


Local  data  ele 


"mid"  stores  the  id  of  the  shared  memory  segment 
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c  Interrupts  and  signals.  None 

d  Algorithms-  None 

e.  Error  handling,  logs  an  error  if  the  shared  memory  segment 

cannot  be  attached,  and  returns  1. 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the  bzero 
CSU:  None 

h.  Logic  flow-  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.1.4.  CSU  wait.for.msg. 

The  wait_for_insg  CSU  waits  for  new  messages  in  ttve  Fan-Out  queue.  These 
messages  are  hrom  the  CSC  dmcc_sim_rx  with  notifications  of  a  new  DMCC 
PDU  arrival,  or  from  CSC  dmcc  with  login,  logout,  message  read,  or  new 
CEOIs/Groups.  The  following  paragraphs  provide  design  information  for  this 
CSU. 


4.1.4.1  CSU  wait.for.msg  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  eqxiipment  package- 

4.1.4.2  CSU  wait.for.msg  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
wait_for_msg  CSU. 


a. 


Input/output  data  el 


INPUTS:  None 


OUTPUTS:  None 
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b.  Local  data  elements. 

"maxshmem"  contains  the  highest  address  in  the  shared 
memory  segment 

c.  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Frror  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
wait_for_msg  CSU: 

"fanout.qid" 

"msgin" 

"dm_rqsts'' 

"shmaddr" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.1.5  CSU  empfixedstr. 

The  empfixedstr  CSU  compares  2  vectors  of  strings  and  returns  true  if  any 
string  in  one  matches  one  in  the  other.  The  following  paragraphs  provide 
design  information  for  this  CSU. 

4.1.5.1  CSU  empfixedstr  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 
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4.1.5J!  CSU  cmpfixcdskr  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
empfixedstr  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"ain"  is  a  pointer  to  a  vector  of  strings 

"bin"  is  a  pointer  to  a  vector  of  strings 

"size"  is  the  maximum  l^igth  of  ea^  string 

"nbtocompare"  is  a  count  of  the  number  of  strings  to  compare 

OUTPUTS: 

"empfixedstr"  is  1  if  there  is  a  match,  or  0  if  there  is  no  match 

b.  Local  data  elements. 

"i","j"  are  local  indices 

"alen","blen"  are  the  lengfits  of  each  string  being  compared 
"a","b"  are  pointers  that  hold  the  address  of  the  current  strings 
being  compared 

c.  Interrupts  and  signals.  None 

d  Algorithms.  None 

e.  Error  handling.  Returns  0  if  no  match,  otherwise  1 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
empfixedstr  CSU:  None 

h.  Logic  flow.  2  nested  for  loops  running  over  each  vector  of 
strings. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  CEOI  strings  must  be  no  larger  than  "size"  or 
terminate  with  a  NULL 
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4.1.6  CSV  trimup. 

The  trimup  CSU  trims  trailing,  leading  and  embedded  spaces,  and  upcases  all 
letters,  in  a  fixed  size  string.  The  following  paragraphs  provide  design 
information  for  this  CSU. 

4.1.6.1  CSU  trimup  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.1.6.2  CSU  trimup  design. 

The  information  identified  below  represents  the  detailed  design  of  the  trimup 
CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"a"  is  a  pointer  to  a  string 
"size"  is  the  size  of  the  string 

OUTPUTS: 

"a"  is  a  pointer  to  a  string— the  trimmed  and  upcased  string 
overwrites  the  input  string 

b.  Local  data  elements. 

None 

c  Interrupts  and  signals.  None 

d  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
trimup  CSU:  None 

h.  Logic  flow.  For  loop  over  each  character  in  string. 

i.  Data  structures.  None 
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j.  Local  data  files  or  database.  None 

k.  Limitations.  CEOI  strings  must  be  no  larger  than  "size"  or 
termixuite  with  a  NULL 

4.1.7  CSU  cleanup_xchild. 

The  deanup.xchild  CSUcleans  up  after  an  XClient-child  logs-out  or  is  iK>ticed 
to  have  disappeared.  It  sends  SIGHUP  and  SIGKILL  to  die  c^d  process,  and 
then  tries  to  retrieve  any  messages  left  in  the  Fan-Out  queue  for  that  process. 

If  any  messages  are  retrieved  then  the  "shmem.addr"  pointer  is  used  to 
locate  messages  destined  for  the  process,  and  decrements  the  "nbr.readers" 
counter.  The  following  paragraphs  provide  design  information  for  this  CSU. 

4.1.7.1  CSU  cleanup.xchild  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.1.7.2  CSU  cleanup.xchild  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
cleanup.xchild  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"id"  is  the  process  id  of  the  X-Client  child  process 
OUTPUTS:  None 

b.  Local  data  elements. 

None 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 


Page  39 


Document  ADST/WDL/TR— 93-003036 


March  31, 1993 


g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
cleanup.xchild  CSU: 

"fanout_qid" 

h.  Logic  flow.  While  loop  over  all  messages  retrieved  from  queue. 

i.  Data  structures.  None 

j.  T  ncal  data  files  or  database.  None 

k.  Limitations.  None 

42.  CSC  build  pdu. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
build  pdu  CSC  in  terms  of  data  flow  between  the  CSU's  of  this  CSC  «md 
identifies  all  CSU  interfaces  that  are  external  to  the  build  pdu  CSC. 

The  following  diagram  details  the  top  level  structure  of  the  build_pdu  CSC: 
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Figure  7  build.pdu  Structure 
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4^1  CSU  setdtg. 

The  setdtg  CSU  returns  the  current  Zulu  date-time  group  to  the  caller.  It  The 
following  paragraphs  provide  design  information  for  this  CSU. 

4,2.1.!  CSU  setdtg  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.2.1.2  CSU  setdtg  design. 

The  information  identified  below  represents  the  detailed  design  of  the  setdtg 
CSU. 

a.  Input /output  data  elements. 

INPUTS: 

'"dtg"  is  a  pointer  to  a  data  store  for  the  dtg 
OUTPUTS: 

"dtg"  is  a  pointer  to  a  data  store  for  the  dtg 

b.  Local  data  elements. 

"tp"  contains  current  time 

"tm"  contains  localtime 

"buf"  contains  formatted  dtg  string 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
setdtg  CSU:  None 

h.  Logic  flow.  Single  pass. 
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i.  Data  structures.  None 

j.  Local  data  files  or  rfatahasg.  None 

k.  LimitaHons.  None 

AJU.  CSU  bldAck. 

The  bldAck  CSU  builds  and  sends  an  Ack  Digital  Message.  The  following 
paragraphs  provide  design  information  for  tl^  CSU. 

4.12.1  CSU  bldAck  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4,2^  CSU  bldAck  design. 

The  information  identified  below  represents  the  detailed  design  of  the  bldAck 
CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"targetCEOI"  is  a  pointer  to  destination  CEOI 
OUTPUTS:  None 

b.  Local  data  elements. 

None 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
bldAck  CSU: 

"pdu" 
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h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4,2.3  eSU  bldFieeTexL 

The  bldFreeText  C5U  builds  and  sends  a  FreeText  Digital  Message.  The 
following  paragraphs  provide  design  information  for  this  CSU. 

4.2.3.1  CSU  bldFreeText  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.2.3.2  CSU  bldFreeText  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
bldFreeText  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"targetCEOI"  is  a  pointer  to  the  destination  CEOI  strings 
"annotation"  is  a  pointer  to  the  annotation  string 
"prio"  is  the  PDU  priority 
"FreeText"  is  a  pointer  to  the  free  text  string 

OUTPUTS:  None 

b.  Local  data  elements. 

None 

c  Interrupts  and  signals.  None 

d  Algorithms.  None 

e.  Error  handling.  None 
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f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
bldFreeText  CSU: 

"pdu" 


h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4^4  CSU  bldSpoL 

The  bldSpot  CSU  builds  and  sends  the  SPOT  Digital  Message.  The  following 
paragraphs  provide  design  information  for  this  CSU. 

4^.4.1  CSU  bldSpot  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4JZ.4JZ  CSU  bldSpot  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
bldSpot  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"targetCEOI"  is  a  pointer  to  the  destination  CEOI  strings 

"aimotation"  is  a  pointer  to  the  aimotation  string 

"prio"  is  the  PDU  priority 

'TimeSighted"  is  a  pointer  to  the  time  sighted  dtg 

"ObeserverLocation"  is  a  pointer  to  the  observers  UTM 

'TargetQuantity"  is  a  count  of  the  targets 

"Observerlntentions"  is  a  byte  indicating  the  observers 

intentions 

'TargetT)rpe"  is  a  byte  indicating  the  type  of  die  target 
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'TargetActivity"  is  a  byte  indicating  the  activity  of  the  target 
'TargetDirection"  is  a  byte  indicating  the  direction  of  the  target 
'TargetSpeed"  is  a  pointer  to  the  speed  of  the  target 
'TargetLocation"  is  a  pointer  to  the  target's  UTM 
'TargetUnit"  is  a  byte  indicating  the  unit  of  the  target 

OUTPUTS:  None 

b.  Local  data  elements. 

None 

c.  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
bldSpot  CSU: 

"pdu" 


h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4^5  CSU  bldRequest 

The  bldRequest  CSU  builds  and  sends  the  Request  Digital  Message.  The 
following  paragraphs  provide  design  information  for  this  CSU. 

4^5.1  CSU  bldRequest  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commuiucations  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  commuiucations 
subftmction  of  a  helicopter  mission  equipment  package. 
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4JL5^  CSU  bldRequcst  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
bldRequest  CSU. 

a.  Input/output  data  pl«»ments. 

INPUTS: 

"targetCEOI"  is  a  pointer  to  the  destination  CEOI  strings 
"annotation"  is  a  pointer  to  the  aniu>tation  string 
"prio"  is  the  PDU  priority 
"ReportType"  is  a  byte  indicating  the  type  of  report 
"ReconType"  is  a  byte  indicating  the  type  of  RECON 

OUTPUTS:  None 

b.  Uzcaldata  etemmts- 
None 

c.  Interrupts  and  signals.  None 

d  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g-  Use  of  other  elements.  Other  elements  that  are  used  by  the 
bldRequest  CSU: 

"pdu" 

h.  Logic  flow.  Single  pa». 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 

4,2.6  CSU  bldMove. 

The  bldMove  CSU  builds  and  sends  Move  Digital  Messages.  The  following 
paragraphs  provide  design  information  for  tl^  CSU. 
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4.2.6.1  CSU  bldMove  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machihe>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.2.6.2  CSU  bldMove  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
bldMove  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"targetCEOI"  is  a  pointer  to  the  destination  CEOI  strings 

"annotation"  is  a  pointer  to  the  aimotation  string 

"prio"  is  the  PDU  priority 

"TargetID"  is  a  pointer  to  the  id  of  the  target 

'Task"  is  a  byte  indicating  the  task 

"Who"  is  a  byte  indicating  who 

"When"  is  a  b)rte  indicating  when 

"DTG"  is  a  pointer  to  a  dtg 

OUTPUTS:  None 

b.  Local  data  elements. 

None 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
bldMove  CSU: 

"pdu" 


h.  Logic  flow.  Single  pass. 
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i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations-  None 


AJL7  CSU  bldMTO. 

The  bldMTO  CSU  builds  and  sends  MTO  Digital  Messages.  The  following 
paragraphs  provide  design  information  for  this  CSU. 

4.2.7.1  CSU  bldMTO  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-inteHace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

AJ2.7 J1  CSU  bldMTO  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
bldMTO  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"targetCEOI"  is  a  pointer  to  the  destination  CEOI  strings 
"annotation"  is  a  pointer  to  the  animtation  string 
"prio"  is  the  PDU  priority 

"MissionStatus"  is  a  byte  indicating  the  status  of  die  mission 
"RequestAdjustment"  is  a  byte  indicating  an  adjustment  request 
"EnterTarget"  is  a  byte  indicating  die  target  to  enter 
"EndMission"  is  a  byte  indicating  the  mission  end 


OUTPUTS:  None 
b.  Local  data  elements. 

None 

c  Interrupts  and  signals-  None 

d.  Algorithms.  None 
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e.  Error  handling.  None 

t  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
bldMTO  CSU: 

"pdu" 


h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4^8  CSU  bldShot 

The  bldShot  CSU  builds  and  sends  Shot  Digital  Messages.  The  following 
paragraphs  provide  design  information  for  this  CSU. 

4L2.8.1  CSU  bldShot  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4JL8.2  CSU  bldShot  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
bldShot  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"targetCEOI"  is  a  pointer  to  the  destination  CEOI  strings 
"aiuu>tation"  is  a  pointa*  to  the  annotation  string 
"prio"  is  the  PDU  priority 

"Missioi^tatus"  is  a  byte  indicating  the  status  of  the  mission 
''RoundsFired"  is  a  byte  indicating  the  rounds  fired 
'TmpactTime"  is  a  b)de  indicating  the  time  of  impact 
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OUTPUTS:  None 
b.  Local  data  elements. 

None 

c  Interrupts  and  signals.  None 

d  Aigorithma.  None 

e.  Error  handUng.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
bldShot  CSU: 

"pdu" 

h.  Lope  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitarions.  None 

4^9.  CSU  bldSplash. 

The  following  paragraphs  provide  design  information  for  this  CSU. 

42.9.1  CSU  bldSplash  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commimications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

42.92  CSU  bldSplash  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
bldSpUsh  CSU. 
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a.  Input/outPut  data  glgmgnts. 

INPUTS: 

"targetCEOI"  is  a  pointer  to  the  destination  CEOI  strings 
"annotation"  is  a  pointer  to  the  annotation  string 
"prio"  is  the  PDU  priority 

"MissionStatus"  is  a  byte  indicating  the  status  of  the  mission 
"RoundsFired"  is  a  byte  indicating  the  rounds  fired 
"ImpactTime"  is  a  byte  indicating  the  time  of  impact 

OUTPUTS:  None 

b.  Local  data  elements. 

None 

c.  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
bldSplash  CSU: 

"pdu" 


h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4^10  CSU  fwdpdu. 

The  fwdpdu  CSU  builds  and  sends  forwarded  Digital  Messages.  The  following 
paragraphs  provide  design  information  for  this  CSU. 
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4^10.1  CSU  fwdpdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.2.10.2  CSU  fwdpdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
fwdpdu  CSU. 

a.  Input /output  data  elements. 

INPUTS: 

"fwdpdu"  is  a  pointer  to  the  destination  CEOI  string 
"tpdu"  is  a  pointer  to  a  pdu 

OUTPUTS:  None 

b.  Local  data  elements. 

"pdu_size"  contains  the  size  of  the  pdu 
c  Interrupts  and  signals.  None 

cL  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
fwdpdu  CSU: 

"pdu" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 
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4,3  CSC  ipc 

The  following  diagram  details  the  top  level  structure  of  the  ipc  CSU: 


Figure  8  CSC  ipc  Structure 

CSC  ipc  partially  satisfies  System  Segment  Specification  requirements  3.2.1.2.1 
and  32.1.2.2.1. 
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The  following  paragraphs  imder  this  section  describe  the  relationship  of  the 
ipc  CSC  in  terms  of  data  flow  between  the  CSU's  of  this  CSC  and  identifies  all 
CSU  interfaces  that  are  external  to  the  ipc  CSC. 


43.1  CSU  dmsinit 

The  dmsinit  CSU  handles  attaching  h)  the  message  queues  and  to  the  shared 
memory  segment.  The  following  paragraphs  provide  design  information  for 
this  CSU. 


43.1.1  CSU  dmsinit  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.3.13  CSU  dmsinit  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dmsinit  CSU. 

a.  InputZoutput  data  elements. 

INPUTS: 

"mode"  indicates  whether  the  caller  is  receiving  or  transmitting 
to  the  Ethernet 

OUTPUTS:  None 

b.  Local  data  elements. 

"shmem.size"  is  the  maximum  size  of  the  shared  memory 
segment 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling,  returns  0  if  uiuible  to  attach  to  queues  and 
shared  memory 

f.  Data  conversion.  None 
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g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dmsinit  CSU: 

"fanoutqid" 

"incoming.shmid" 

"outgoingqid" 

h.  Logic  flow-  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 

4.3,2  CSU  dms.senddm. 

The  dms.senddm  puts  a  message  in  the  Outgoing  queue.  The  following 
paragraphs  provide  design  information  for  this  CSU. 

43.2.1  CSU  dms.senddm  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commuiucations  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4332  CSU  dms.senddm  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dms.senddm  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"buf "  is  a  pointer  to  the  message 
'l7uflen"  indicates  the  size  of  the  message 

OUTPUTS:  None 

b.  Local  data  elements. 

None 

c  Interrupts  and  signals.  None 
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d  Algorithms.  :Jone 

e.  Error  handling,  returns  0  if  unable  to  put  the  message  in  the 
queue 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dms.senddm  CSU: 

"outgoingqid" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j .  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.3.3  CSU  dms.recvdm. 

The  dms_recvdm  waits  for  any  message  to  appear  in  the  Outgoing  queue. 

The  following  paragraphs  provide  design  information  for  this  CSU. 

4.3.3.1  CSU  dms.recvdm  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  eqmpment  package. 

43.3.2  CSU  dms.recvdm  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dms_recvdm  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

'T>uf "  is  a  pointer  to  a  buffer  to  contain  the  received  message 
OUTPUTS: 

"buf "  is  a  pointer  to  a  buffer  to  contain  the  received  message 
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b.  Local  data  elements. 

"msgin"  contains  the  received  message 
c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  Returns  0  if  unable  to  retrieve  the  message  from 
the  queue 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dms_recvdm  CSU; 

"outgoingqid" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  LimitaitiQns.  None 
43.4  CSU  dm8_getfreerecord. 

The  dms_getfreerecord  CSU  tries  to  find  a  free  record  in  shared  memory  by 
calling  dms.seekrecord  CSU,  and  on  error,  it  will  sleep  and  try  again,  for  a 
limit  of  MAXRETRY.  The  following  paragraphs  provide  design  information 
for  this  CSU. 

43.41  CSU  dm8_getfreerecord  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-inte^ace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.43  CSU  dms_^etfreerecord  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dms_getfreerecord  CSU. 
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a.  Input/output  data  elements. 

INPUTS:  None 
OUTPUTS: 

"dms_getfreerecord"  contains  the  address  of  a  free  record  in 
shared  memory 

b.  Logal  data  elements. 

"recaddr"  contains  address  of  hree  record 
c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  Return  0  if  unable  to  find  a  free  record 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dms_getfreerecord  CSU:  None 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


43.5  CSU  dms.seekrecord. 

The  dms_seekrecord  CSU  finds  the  next  firee  record  in  the  shared  memory 
segment  and  returns  the  address  of  the  record.  The  following  paragraphs 
provide  design  information  for  this  CSU. 

43.5.1  CSU  dm8_8cckiecord  reqoiiements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commuxucations  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4.3.5^  CSU  dms.seekiccord  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dms.seekrecord  CSU. 


a.  Input /output  data  elements. 

INPUTS:  None 
OUTPUTS: 

"dms.seekrecord"  contains  the  address  of  a  free  record  in  shared 
memory 

b.  Local  data  elements. 

"maxshmem"  contains  the  highest  address  in  the  shared 
memory  segment 

c.  Interrupts  and  signals.  None 

d  Algorithms.  None 

e.  Error  handling.  Returns  0  if  unable  to  find  a  free  record 

f.  Data  conYfixsion-  None 

g  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dms.seekrecord  CSU: 

"shmaddr" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations-  None 


43.6  CSU  dms.notify. 

The  dms.notify  CSU  sends  a  notification  of  a  new  message  arrival  to  dms 
CSU.  The  following  paragraphs  provide  design  information  for  this  CSU. 
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4.3.6.1  CSU  dms.notify  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.3.6.2  CSU  dms.notify  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dms_notify  CSU. 

a.  Input /output  data  elements. 

INPUTS; 

"new_dm_address"  contains  the  address  of  the  new  message  in 
the  shared  memory  segment 

OUTPUTS:  None 

b.  Local  data  elements. 

"msgout"  contains  the  MSG.DMAVAIL  message 
c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  Returns  0  if  uxuible  to  put  the  message  in  the 
queue 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dms_notify  CSU: 

"fanoutqid" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 
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4J.7  CSU  dms.bcopy. 

The  dms_bcopy  CSU  copies  a  buffer  from  the  calkr  into  shared  memory,  and 
then  notifies  dms  CSU.  The  following  paragraphs  provide  design 
information  for  this  CSU. 

4J.7.1  CSU  dms.bcopy  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4  J.7.2  CSU  dms.bcopy  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dms_bcopy  CSU. 

a.  Input /output  data  elements. 

INPUTS: 

"'buf"  is  a  pointer  to  a  buffer  contaiiung  the  message 
'T>uflen"  contains  the  length  of  the  buffer 
"dests"  is  a  pointer  to  a  vector  of  CEOI  strings 
"exid"  is  byte  containing  the  id  of  the  exercise 

OUTPUTS:  None 

b.  Local  data  elements. 

"nextrec"  contains  addre^  of  next  free  record  in  shared  memory 
segment 

c  Interrupts  and  signals.  None 

d  AlgorittolS-  None 

e.  F.rrnr  handling.  Returns  0  if  unable  to  copy  new  message  into 
shared  memory  segment 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dins_bcopy  CSU:  None 

h.  Logic  flow.  Single  pass. 
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i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


43.8  CSU  dmslogin. 

The  dmslogin  CSU  creates  a  child  process  for  the  caller  to  handle 
communication  with  dms  CSU.  The  child  then  sends  a  login  message  to  dms 
CSU.  The  child  process  enters  an  infinite  for  lo<^  waiting  for  a  new  message 
arrival  notification  from  the  dms  CSU.  The  following  paragraphs  provide 
design  information  for  this  CSU. 

43.8.1  CSU  dmslogin  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-inteirface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

43.83  CSU  dmslogin  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dmslogin  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"dests"  is  a  pointer  to  a  vectcv  of  CEOI  strings 
"exid"  contains  the  exerdse  id  of  the  operator 

OUTPUTS:  None 

b.  Local  data  elements. 

"p"  contains  id  of  pipes 

"msgout"  contains  message  sent  out  to  fan-out  queue 
"msgin"  contains  messages  received  ^m  fan-out  queue 
"shmem.size"  contains  the  size  of  the  shared  memory  segment 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 


Page  63 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


e.  Error  handling.  Returns  0  if  unable  to  create  pipes 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dmslogin  CSU: 

"incoming_shmem" 

"fanoutqid" 

"outgoingqid" 

"childpid" 

"cur_exerciseid" 

"cur_opername" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


43.9  CSU  dmsnewdests. 

Ilie  dmsnewdests  CSU  sends  a  new  set  of  CEOIs  and  Groups  that  the  operator 
wishes  to  receive.  The  following  paragraphs  provide  design  information  for 
this  CSU. 


43.9.1  CSU  dmsnewdests  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.93  CSU  dmsnewdests  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dmsnewdests  CSU. 


a. 


Input/output  data  elei 


INPUTS: 

"ceoi"  contains  the  new  vector  of  CEOI/Group  strings 
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OUTPUTS:  None 

b.  Local  data  elements. 

"msgout"  contains  message  sent  out  to  fan-out  queue 

c.  Interrupts  and  signals.  None 

d  Algorithms^  None 

e.  Error  handling.  Returns  0  if  uiuible  to  put  message  in  queue 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dmsnewdests  CSU: 

"fanoutqid" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local,  data  filfis.oi:..(ktabasfi.  None 

k.  Limitations.  None 

4,3.10.  CSU  dmslogouL 

The  dmslogout  CSU  sends  a  logout  message  to  the  dms  CSC.  The  following 
paragraphs  provide  design  iidormation  for  this  CSU. 

43.10.1  CSU  dmslogout  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.103  CSU  dmslogout  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dmslogout  CSU. 
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a.  Input /output  data  elements. 

INPUTS:  None 
OUTPUTS:  None 

b.  Local  data  elements. 

"msgout"  contains  message  sent  out  to  fan-out  queue 
c  Interrupts  and  signals.  None 

cL  Algorithms.  None 

e.  Errnr  handling.  Returns  0  if  unable  to  put  message  in  queue 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dmslogout  CSU: 

"fanoutqid" 

"childpid" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 

4J.11  CSU  dins_getdin. 

The  dms_getdm  CSU  reads  from  the  pipe  between  the  X-Client  parent  and  its 
child.  The  CSU  hangs  imtil  the  read  completes.  The  following  paragraphs 
provide  design  information  for  this  CSU. 

4J.11.1.  CSU  dins_getdm  requirements. 

This  CSU  satisfies  internaUy  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  commuiucations 
subfunction  of  a  helicopter  mission  equipment  package. 
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43.11JI  CSU  dins_getdin  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dms_getdm  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"p"  contains  the  id  of  the  pipe 

"pdu"  is  a  pointer  to  buffer  that  will  contain  the  message  read 
from  the  pipe 

OUTPUTS: 

"pdu"  is  a  pointer  to  buffer  that  will  contain  the  message  read 
from  the  pipe 

b.  Local  data  elements. 

"nbytes"  contains  number  of  bytes  read 

c.  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Eripi  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dms_getdm  CSU: 

"p" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  LimitatiQns.  None 


43.12  CSU  dms_getexid. 

The  dms^etexid  CSU  returns  the  exercise  id  of  the  session  to  the  caller.  The 
following  paragraphs  provide  design  information  for  this  CSU. 
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4.3.12.1  CSU  dms_getexid  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machihe-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4J.12J2  CSU  dms^etexid  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dms_getexid  CSU. 

a.  Input /output  data  elements. 

INPUTS:  None 
OUTPUTS: 

"dms_getexid"  contains  the  exercise  id  of  the  session 

b.  Local  data  elements. 

None 

c  Interrupts  and  signals-  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dms_getexid  CSU: 

"cur_exerdseid" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 
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4.3.13  CSU  dms_getopemame 

The  dms_geto[>emame  CSU  returns  the  operators  name  to  the  caller.  The 
following  paragraphs  provide  design  information  for  this  CSU. 

4.3.13.1  CSU  dms_jetopemanie  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.13J2  CSU  dms_getopemame  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dms_getopername  CSU. 

a.  Input/output  data  elements. 

INPUTS:  None 
OUTPUTS: 

"dms_g:etopername"  contains  the  operators  name 

b.  Local  data  elements. 

None 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
dms_getopername  CSU: 

"cur_opername" 

h.  Logic  flow.  Single  pass. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 
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k.  Limitations.  None 


4.4.  CSC  Ethernet. 

The  following  paragraphs  tmder  this  section  describe  the  relationship  of  the 
Ethernet  CSC  in  terms  of  data  flow  between  the  CSLTs  of  this  CSC  ar^ 
identifies  all  CSU  interfaces  that  are  external  to  the  Ethernet  CSC. 

CSC  Ethernet  partialy  satisfies  System  Segment  Spedfiction  3.2.1.2.2.2  and 

3.2.1.2.2.1. 

4.4.1.  Sub-Level  CSC  dmcc.sim_rx.c 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
dmcc.sim  rx  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of  this 
Sub-level  CSC. 

The  following  diagram  depicts  the  structure  of  the  dmcc  sim.tx  sublevel 
CSC. 
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Figure  9  Sublevel  CSU  dmcc.sim_rx  Structure 
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4.4.1.1  CSU  main 

The  main  CSU  is  a  driver  for  the  dmcc_sim_rx  function,  and  calls  routines  to 
attach  shared  memory,  set  ethemet  interface  mode  for  receiving  packets,  log 
message  status  counters,  validate  Ethemet  type,  validate  the  LLC  sublayer 
header,  and  decode  the  input  message  all  within  a  while-loop. 

4.4.1.1.1  CSU  main  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  commuiucations 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.I.I.2.  CSU  main  design. 

The  information  identified  below  represents  the  detailed  design  of  the  main 
CSU. 

Syntax  of  invoking  this  CSU: 
dmcc_sim_rx 

a.  Input/QMtput  data  elements- 
lOTUTS: 

"argv"  is  the  command  line  input  argument  containing  the 
Ethemet  card  name. 

OUTPUTS: 

None. 

b.  Local  data  elements- 

"i"  is  an  integer  for-loop  counter. 

c.  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling, 
display  message  with  printf. 

f.  Data  conversion.  None 
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g.  Use  of  Other  fil 
Data  elements: 


SIM.interface.name 
Exerdse.ID 
Library  routines: 
if  -else 
printf 
exit 

eSUs: 


dmsinit 

SIM_rx_netif 


h.  Lope  flow. 

set  Exercise  ID  to  pass  all  type  of  messages; 
if  command  line  argument  is  less  than  two 
print  the  proper  command  usage; 

else 

get  the  SIMNET  interface  name  from  command  line  argument; 
invoke  dmsinit  to  initialize  message  queue; 
if  dmsinit  return  error 

output  error  message  and  exit; 
invoke  SIM„rx_netif; 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitarions.  None 


4.4.1  J  eSU  SIM.rx_netif 

The  SIM.rx.netif  CSU  call  function  to  set  the  receiving  Ethernet  interface 
mode  then  within  an  infinite  loop,  it  reads  in  the  input  message,  validates  its 
Ethernet  type,  validates  the  LLC  sublayer  header,  calls  function  to  update  the 
message  status  counters  and  to  decode  the  input  message. 

4.4.1.2.1  CSU  SIM_rx.netif  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4.4.1.2JL  CSU  SlM_n(.netif  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SIM_rx_netif  CSU. 

Syntax  of  invoking  this  CSU: 

SIM_rx_netif(); 

a.  Input/output  data  elements. 

INPUTS: 

None. 

OUTPUTS: 

None. 

b.  Local  data  elements. 

"i"  is  an  integer  for-loop  coimter. 

"pType"  is  an  unsigned  short  integer  containing  the  input 
message's  Ethernet  type. 

"frame.seq"  is  long  or  64  bit  integer  indicating  the  frame 
sequence. 

"timervalues"  is  an  instance  of  struct  timeval. 

"timerzone"  is  an  instance  of  struct  timezone. 

"iovf]"  is  an  instance  of  struct  iovec. 

"byte.read"  is  an  integer  storage  containing  the  number  of 
message  byte  read. 

"prom"  is  of  type  ether.addr. 

"protocoLid"  is  a  local  global  unsigned  integer  storage 
containing  the  protocol  id  of  the  received  message. 

"etherPacket"  is  a  static  ether_packet  type  containing  the  input 
message  structure. 

C  Interrupts  and  signals.  None 

d.  Algorithms.  None. 

e.  Error  handling. 

1.  invoke  shutdown_SIM.rx  to  display  messages. 

2.  return  1  for  error. 


f. 


Data.  convi 


None 
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g.  Use  of  other  elements. 
Data  elements: 

SIM.sigrec, 

SIM.rx.etherFd, 

SIM_interface_name, 

SIM_rx_index, 

frame_bu£fl][]. 

Library  routines: 
if  -  else, 
while  -  loop, 
printf, 

gettimeofday, 

memcpy, 

readv. 


CSUs: 

ether_open, 
shutdown.SIM  rx, 
ALPDU_SIM_decode, 
logger. 


h.  Logic  flow- 

initialize  SIM_sigrec  and  frame.seq  to  zero; 

set  timerzone.tz.dsttime  «  DST.NONE(  with  no  specific  time  zone); 

invoke  ether.open  to  set  the  assigned  Ethernet  card  with  promiscuous 
receive  mode; 


if  ether.open  return  error 

invoke  shutdown^SIM.rx  to  output  error 
message  and  return  with  one; 

for  i  <  the  max  of  MAX.DATAGRAM  •»>(  1  for  discard  data  storage) 

set etherPacketpktouffi] points tothe  address  of 

frame_bu£f[i][0]; 

initialize  header  bufier's  lei^th  field  to  the  number  of  possible  MAC 
header  lengto  and  base  field  pcwts  to  the  beginning  of  toe  input 
message; 

While  -  forever  loop 

if  the  number  of  non-processed  input  message  <  maximum  datagram 
is  allowed  in  the  ii^t  bufier 
initialize  data  buffer's  len  field  to 
maximum 

number  of  byte  a  message  is  allowed  and 
base  field  to  the  current  index  message 
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input  buffer; 

invoke  readv  to  read  in  message; 
if  number  of  byte  read  is  <»  zero 

invoke  shutdown_SIM_rx  to  output  the 
proper  error  message  then  return  to 
dmcc_sim_rx  with  an  error; 
else 

invoke  gettimeofday  to  stamp  the 
incoming  message; 

if  the  input  message's  Ethernet  type  field 
is  not  an  valid  SIMNET  message 
invoke  logger  to  log  the  Bad  Ether 
Type  error  count; 
else 

if  protocol_id  is  not  valid; 

invoke  logger  to  log  the 
BAD.PROTOCOLJD  counter; 
else  if  DSAP  is  not  valid 
invoke  logger  to  log  the  BAD.DSAP 
else  if  SSAP  is  not  valid 
invoke  logger  to  log  the  BAD^SSAP 
else  if  control  is  not  valid 
invoke  logger  to  log  the 
coimter; 
else 

invoke  ALPDU_SIM_decode  to 
message; 

increment  the  circular  SIM_rx.iiulex; 
increment  SIM_sigr€^  to  indicate  the  number  of 

messages  that  have  sent  to  ALPDU_SIM_decode  but 

not  yet  been  processed; 

else 

invoke  readv  to  read  in  the  message  to  the 
last  datagram  storage  are  in  input  buffer; 
invoke  logger  to  log  the  Trash  Received 
message  counter; 

return  to  caller; 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 


counter; 

counter; 

BAD.CONTROL 
decode  the  input 
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k.  Limitations. 

l.  Superuser  privilege  is  required  to  set  ethernet  function. 

2.  Only  accept  message  if  the  number  of  not  yet  processed  message  does 
not  exceed  the  limit  of  the  input  buffer. 


4.4.13  CSU  ALPDU.SIM.decode 

The  ALPDU_SIM_decode  CSU  split  up  the  incoming  user  data  into 
individual  ALPDUs  since  there  may  be  multiple  ALPDUs  in  one  user 
datagram  and  call  function  to  validate  the  Exercise  ID  and  validate  the 
ALPDU  format. 


4.4.13.1  CSU  ALPDU^IM.decode  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.1.33.  CSU  ALPDU^IM.decode  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ALPDU.SIM.decode  CSU. 

Syntax  of  invoking  this  CSU: 

ALPDU_SIM_decode(address  of  the  input  message,  length  of  input 
message/packet,  timestamp); 

a.  Input /output  data  elements. 

INPUTS: 

"  assoc.pkt"  is  an  unsigned  character  pointer  that  points  to  the 
input  message/packet 

"maxjength"  is  an  unsigned  short  integer  storage  contaming 
the  input  message/packet  length. 

"timervalues"  is  of  struct  timeval  containing  the  input 
message/packet  timestamp. 

OUTPUTS:  None. 
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b.  Local  data  elements. 

"assocjength”  is  a  static  unsigned  short  integer  storage  contaiiung  the 
association  length; 

"PDU.kind"  is  a  static  unsigned  character  storage  containing  the  pdu 
type 

"next_assoc_pkt"  is  a  static  unsigned  character  pointer  that  points  to 
the  next  association  layer  pdu  to  be  split. 

"first.frame"  is  an  unsigned  character  flag  indicating  the  first 
association  layer  pdu  of  the  input  packet. 

”valid_frame"  is  a  Boolean  flag  to  in^cate  if  an  association  layer  pdu  is 
in  valid  format. 

c.  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling,  return  with  an  error  integer  of  1. 

f.  Data  conversion.  None 

*  A* 

g.  Use  of  other  elements. 

Data  elements: 

SIM.Assoc.Layer. 

Library  routines: 
if  -  else, 
do  -  while, 
if. 

CSUs: 

check_exercise_ID_SIM, 

Rcv.SIM^APDU, 

check_SIM_ALPDU, 

logger. 

h.  Logic  flow. 

initialize  valid_frame  to  FALSE; 
if  SIM.Assoc_Layer  is  set  to  FALSE 
if  return  of  check.exercise_ID_.SlM  is  valid 

invoke  Rcv_SIM_APDU  with  the  NEW_ALPDU 

parameter; 
else 

invoke  logger  to  increment  the  BAD.EXERCISE.ID 

counter; 

else 

set  next_assoc_pkt  points  to  assoc_pkt; 
invoke  valid.frame  *  check_SIM.ALPDU 
to  check  for  valid  ALPDU  format; 
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if  valid^frame 
set  first_frame  =  TRUE; 

do  -  while  maxjength  >  0  and  check_SIM_ALPDU()  of  the 
next  ALPDU  is  in  valid  format 

if  PDU.kind  is  not  equal  to  padding 

invoke  check_exercise_ID_SIM;  if  valid  exercise 

ID; 

if  this  is  the  first  frame 

invoke  Rcv_SIM_APDU  with  the  NEW„ALPDU 

parameter; 

set  first_frame  to  FALSE; 
else 

invoke  Rcv_SIM_APDU  with  the  CONT_ALPDU 

parameter; 

else  invalid  exercise  ID 
invoke  logger  to  inaement  the 
BAD_EXERCISE_ID  counter; 

subtract  the  last  ALPDU  length  from  the  original  length  by 
max_length  =  max^length  -  assoc.length; 

advance  the  next_assoc_pkt  pointer  by 
next_assoc_pkt  ®  next_assoc_pkt  +  assocjength; 

if  the  entire  packet  is  valid  where  valid.frame  is  TRUE 
invoke  Rcv.SIM.APDU  to  send  the  packet 
onto  SIMNET  by  passing  the  END^ALPDU 
parameter; 

return  valid.frame  status  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations. 

The  global  variable  SIM_Assoc_Layer  must  be  set  TRUE  to  perform  the 
ALPDU  split  up. 


4.4.1.4  CSU  check_exercise_ID_SIM 
The  check_exerdse_ID_SIM  CSU 
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4.4.1.4.1  CSU  check_exercise_ID_SIM  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.I.4.2.  CSU  check_exercise_ip_SIM  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
check_exercise_ID_SIM  CSU. 

Syntax  of  invoking  this  CSU: 

a.  Input /output  data  elements. 

INPUTS: 

”new_PDU"  is  an  unsigned  character  pointer  that  points  to  the 
input  association  layer  pdu. 

OUTPUTS: 

"valid_frame"  is  a  Boolean  flag  to  indicate  the  status  of  the 
input  pdu's  exercise  ID 

b.  Local  data  elements.  None 

c.  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

Data  elements: 

pass.all, 

Exerdse.ID. 

Library  routines: 
if. 

CSUs: 

None. 
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h.  Logic  flow. 

set  valid.frame  =  TRUE; 

if  pass.all  is  FALSE  and  the  exercise  ID  of  .new.PDU  does  not  equal  to 
Exercise.ID 

set  valid_frame  »  FALSE; 
return  valid_frame; 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations. 

4.4.1.5  CSU  check_SIM_ALPDU 

The  check_SIM_ALPDU  CSU  checks  for  a  valid  ALPDU  format.  It  returns 
FALSE  if  invalid  and  logs  the  error  of  TRUE  if  valid. 


4.4.1.5.1  CSU  check.SIM.ALPDU  design  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.4.I.5.2.  CSU  check_SlM.ALPDU  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
check.SIM^ALPDU  CSU. 

Syntax  of  invoking  this  CSU: 

check_SIM_ALPDU(assoc.pkt,  maxjength,  assoc.length,  PDU.kind); 
a.  Input/output  data  elements. 

INPUTS: 

"assoc_pkt"  is  an  unsigi^  character  pointer  that  points  to  the 
input  association  layer  pdu  address. 

"max.length"  is  an  unsigned  short  integer  containing  the 
number  of  input  packet  bytes  left  for  splitting. 

"assoc^ength"  is  an  unsigned  short  pointer  that  points  to  the 
number  bytes  in  the  input  association  layer  pdu. 
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"PDU.kind"  is  an  unsigned  character  pointer  that  points  to  the 
association  layer  pdu's  type. 

OUTPUTS: 

"valid_frame"  is  an  integer  storage  containing  the  Boolean 
value  to  be  returned.  It  indicates  whether  or  not  the  input 
association  layer  pdu  is  in  a  valid  ALPDU  format. 

b.  Local  data  elements. 

"assoc.PDU"  is  a  pointer  of  AssocPDU.type  that  points  to  the  input 
association  pdu. 

c.  Interrupts  and  signals.  None 

d.  Algorithms- 

set  up  association  parameters. 

check  to  see  if  length  is  correct  and  still  bytes  to  process, 
check  to  see  if  its  a  valid  association  pdu. 
check  to  see  if  its  a  Digital  Message  Ftotocol  PDU. 
return  the  status  of  check. 

e.  Error  handling- 

invoke  logger()  to  log  all  errors  in  a  counter  format. 

f.  Data  convorsion-  None 

g.  Use  of  other  elements. 

Data  elements: 

ASSCX;_hdr_leng. 

Library  routines: 
if  -  else  if 

CSUs: 

logger. 

h.  LogiC^W- 

initialize  valid_frame  to  TRUE; 
initialize  assoc.PDU  points  to  assoc_pkt; 

assign  the  input  assoc_PDU->PDUkind  to  PDU_kind; 
set  association  length  by  *assoc_length  * 
ASSOC_hdrJeng[*PDU_kind]  + 

(assoc_PDU->DataLength  *  Assoc_MULTIPLIER); 
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if  (‘assccjength  >  maxjength)  or  (maxjength  <»  zero) 
set  valid.frame  to  FALSE; 

invoke  logger  to  increment  the  BAD„ASSOC_LENGTH 

counter; 

else  if  (•PDU^kind  equals  to  an  unknown  kind)  or  (•PDU_kind  >  the 
possible  association  kind) 
set  valid.frame  to  FALSE; 

invoke  logger  to  increment  the  BAD_ASSCX^_KIND 

counter; 

else  if  (assoc_PDU->Protocol  does  not  equals  to  Digital  Message 
Protocol  PDU) 
set  valid.frame  to  FALSE; 
invoke  logger  to  increment  the 

BAD_ASSOC_PROTOCOL  counter; 

return  valid.frame  to  caller; 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.4.1.6  CSU  Rcv_SIM.ALPDU 

The  Rcv_SIM_ALPDU  CSU  strips  out  the  incoming  PDU  and  releases  the 
receive  buffer  by  decrementing  the  global  variable  sigrec  when  through 
processing  that  PDU  and  END.ALPDU  is  received. 


4.4.1.6.1  CSU  Rcv_SIM_ALPDU  design  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  missicm  equipment  package. 

4.4.1.6.2  CSU  Rcv_SIM_ALPDU  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
Rcv_SIM_ALPDU  CSU. 
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Syntax  of  invoking  this  CSU: 

Rcv_SIM_ALPDU(end_ALPDU,  assoc_pkt,  assoc_length, 
timervalues); 

a.  Input /output  data  elements. 

INPUTS: 

"end.ALPDU"  is  an  unsigned  character  containing  the  sequence 
of  input  association  pdu. 

"assoc.pkt"  is  an  uitsigned  character  pointer  that  points  to  the 
input  association  layer  pdu  address. 

"assocjength**  is  an  tinsigned  short  integer  storage  containing 
the  number  b)rtes  in  the  iiq>ut  association  layer  pdu. 
"timervalues"  is  of  struct  timeval  containing  the  input  par^ 
timestamp. 

OUTPUTS:  None 

b.  Local  data  elements. 

"assoc_PDU"  is  a  pointer  of  AssocPDU_type  that  points  to  the  input 
association  pdu. 

"ALPDU.kind"  is  an  unsigned  character  containing  the  input 
association  pdu  type. 

"PDU_length"  is  an  unsigned  short  storage  containing  the  input 
association  pdu  length  in  number  of  bytes. 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handUng.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

Data  elements: 

ASSOC_hdr_leng, 

SIM_Assoc«Layer. 

Library  routines: 
if 

switch  •  case 

CSUs: 

decode_SlM_pkt. 
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h.  Logic  flow- 

initialize  ALPDU.kind  to  an  unknown  kind; 
initialize  assoc_PDU  to  point  to  assoc_pkt; 
initialize  PDU.length  to  assoc.length; 

if  SIM_Assoc_Layer  is  TRUE 
set  ALPDU_kind  *  assoc_PDU->PDUKind; 
set  PDU  Jength  less  the 
ASSOC_hdrJeng(ALPDU.kindJ; 

switch  (end_ALPDU) 
case  continue  ALPDU 
invoke  decode_SIM_pkt  to  decode  the 
input  pdu; 
case  end  ALPDU 

decrement  the  SIM.sigrec  to  indicate  the 
input  packet  is  processed  and  is  about  to 
sent  out  to  the  net; 
case  new  ALPDU 

invoke  decode_SIM_pkt  to  decode  the 
input  pdu; 

return  to  caUer; 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitatjonsr 

This  CSU  depends  on  the  global  variable  SIM.Assoc_Layer  to  know 
whether  the  Association  Layer  is  present  and  should  be 
processed  or  not 

This  CSU  assumes  the  calling  routine  has  filtered  out  all  Padding 
APDUs  and  APDUs  whi^  carry  on  data. 


4.4.1.7  CSU  dm8_decode_SIM^kt 

The  dms  decode_SIM_pkt  CSU  checks  for  a  valid  ALPDU  format  It  returns 
FALSE  if  mvaUd  and  logs  the  error  of  TRUE  if  vaUd. 
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4.4.1.7.1  CSU  dms_decode_SIM_pkt  design  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communicatioits  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.I.7.2.  CSU  dms_decode_SIM_pkt  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
dms_decode_SIM_pkt  CSU. 

Syntax  of  invoking  this  CSU: 

dms  decode_SIM_pkt(time,  old_pkt,  new_pkt,  max_length, 
"  ALPDU.kind); 

a.  Input /output  data  elements. 

INPUTS: 

"time"  is  of  structure  timeval  containing  the  input  association 
pdu  timestamp  -  not  used. 

"old_pkt"  is  an  unsigned  character  points  that  points  to  the 
input  pdu. 

"new_pkt"  is  an  unsigned  character  points  -  not  usedfNULL  is 
passed  in). 

"max_length"  is  an  uitsigned  short  storage  containing  the 
number  bytes  in  the  input  association  layer  pdu. 

"ALPDU.kind"  is  an  uitsigned  character  storage  containing  the 
type  of  pdu  input  -  not  used(NULL  is  passed  in). 

OUTPUTS:  None. 

b.  Local  data  elements. 

"pduhdr"  is  a  pointer  of  DMC_Header_type  that  points  to  the  input 
association  pdu. 

"pducmn"  is  a  pointer  of  DMC_CommonBlock_type. 
c  Interrupts  and  signals.  None 

d.  Aigprithms. 

check  the  PDU  to  make  sure  it  is  a  Digital  Message  else  return  to  caller. 
Offset  to  CommonBlock  to  get  the  CEOIs. 

send  the  received  datagram  to  "dms_copy"  to  copy  buffer  to  DMS 
Shared  Memory. 
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e.  Error  handling- 

output  error  message  with  printf  if  dms.bcopy  failed  to  copy  buffer  to 
DMS  Shared  Memory. 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

Data  elements: 

ASSOC_hdr_leng. 

Library  routines: 
sizeof 
if 

printf 

eSUs: 

dms_bcopy 

h.  Logic  flow. 

set  pduh^  points  to  old_pkt; 

if  pduhdr->HeaderType.SIM.Header.kind  is  not  a  Digital  Message 
return  to  caller; 

offset  to  common  block  with  pduemn  >  (DMC.CommonBlock.type  *) 
(old4>kt  +  sizeof(DMC.Header.type); 

invoke  dms.copy  with  old.pkt,  max.length,  pducmn*>TargetCEOI, 
and  pduhdr->HeaderType.^M  Jfeader.exercise  as  parameters; 

if  dms.copy  returns  zero 
display  error  message "  failed  to  copy  buffer 
to  DK6  Shared  Memory "; 

return  to  caller; 

i.  Data  atmetuMS.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations-  None 


4.4.1^  eSU  logger 

The  logger  CSU  logs  any  unrecognized  data  or  error  conditions  that  may 
occur  while  processing  PDUs  when  logger  is  invoked. 
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4.4.1.8.1  CSU  logger  design  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.1.8.2  CSU  logger  design. 

The  information  identified  below  represents  the  detailed  design  of  the  logger 
CSU. 

Syntax  of  invoking  this  CSU: 

logger(erTCode,  pkt.add,  pkt.length); 

a.  Input /output  data  elements. 

INPUTS: 

"errcode”  is  an  unsigned  character  storage  containing  the  error 
value  which  indicating  the  type  of  error  b^g  logged. 

"pkt.add"  is  an  unsigned  character  pointer  that  points  to  the 
address  of  the  error  pdiL 

"pktjength”  is  an  unsigned  short  storage  containing  the  length 
of  the  error  pdu  in  number  of  bytes. 

OUTPUTS:  None. 

b.  Local  data  elements. 

"now"  is  of  time_t  type. 

"sH"  is  a  character  array  of  size  100. 

c.  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling. 

output  error  message  widi  printf. 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

Data  elements: 

"logger.datafile"  is  an  integer  storage  containing  the  logger  file 
descriptor, 

TILE"  file  type. 
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library  routines: 
fopen 
strftime 
fprintf 
if 

printf 

fflush 

CSUs: 

None 

h.  Logic  flow. 

if  logger.datafile  is  NULL 
invoke  fopen  to  create  "logger_file.dat'' 
with  "append"  opticm; 
if  file  descriptor  returned  by  fopen  equals  to 
NULL 

printf  error  message"could  not  open 

logger_file.dat"; 

return  to  caller; 

set  now  « time(NULL); 

get  current  time  by  invoking  strftimefs,  100, 

"\n%H:%M:%S  on  %A,  %d  %B  %V, 

localtime(&now)); 

invoke  fprintf  to  write  current  time  in  s  to 
logger.datafile; 

invoke  fprintf  to  write  filename  to 
logger.datafile; 

invoke  ^>rintf  to  write  the  message/error  to 
logger.datafile; 

invoke  fflush  to  flush  the  file  descriptor; 
return  to  caller; 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


I 
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4.4.1.9  CSU  ether.open 

The  ether_open  CSU  returns  file  descriptor  for  Ethernet  device  by 
name(”ieO”,  ”leO”,  etc...)-  It  invoke  nioctl  CSU  to  call  the  ioctl  command  for 
opening  the  Ethernet  device. 


4.4.1.9.1  CSU  ether.open  design  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.1.9.2  CSU  ether.open  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ether_open  CSU. 

Syntax  of  invoking  this  CSU: 

ether_open(  name,  type,  address); 


a. 


INPUTS: 

"name"  is  a  character  pointer  containing  the  Ethernet  interface 
name. 

"typ)e"  is  an  unsigned  integer  containing  Ethernet  packet  type, 
"address"  is  an  ettier.addr  type  pointer  containing  the  receiving 
Ethernet  address. 


OUTPUTS: 

"fd"  is  an  integer  storage  containing  the  file  descriptor  of  the 
Ethernet  to  be  returned. 


"ifr"  is  of  ifreq  structure  type; 

"filter"  is  of  packetfilt  type; 

"fptr"  is  an  unsigned  character  pointer; 
"inerfaces"  is  of  char^; 


"i"  is  an  integer  register; 

"flag"  is  a  long  or  64>bit  integer  flag; 


d.  Algorithms.  None 
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e.  Error  handling.  None 

f.  Data  conversion.  None 


g.  Use  of  Other  ela 

Data  elements: 

None 

Library  routines: 
if 

perror 
close 
ioctl 
stmcpy 


CSUs: 


None 


h.  Logic  flow- 

if  name  is  NULL  get  default  ethemet  interface 
interface  =  ether.interfaces(); 
if  ether.interface  returns  zero 
return  -1  to  caller; 

copy  interface  name:  name  «  ^interface; 

invoke  open  to  open  NIT_DEV; 

if  return  error 
return  *1  to  caller; 

if  NTT^DEV  hie  descriptor  >»  FD_SETSIZE 
close  the  file  descriptor  with  close; 
set  ermo  «  empty  ffle; 
rehim  -1  to  ca^r; 

invoke  nioctl(fd,  IjSRDOFT,  (char  *)  RMSGD)  to  get  discrete  message 
from  stream; 

if  return  error 
return  -1  to  caller; 

if  type  does  not  equals  to  ETHEILALLTYPES 
if  type  >  ETHEILALLTYPES 
dose  file  descriptor  with  dose; 
set  ermo  «  EINVAL; 
return  -1  to  caller; 
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I*  push  the  filter  to  prevent  being  flooded  with  extraneous  packets  */ 
if  (niocti(fd,  LPUSH,  "pD  <  0 
return  >1  to  caller; 

fptr  =  &fileter.Pf_Filter[01; 

•fptr-»-+  *  ENF_PUSHWORD  +  ETHEILTYPE  /  sizeof  (short); 
*fptr++  =  ENF_PUSHLIT  I  ENF.EQ; 

•^tr++  ®  htons  ((u_short)typ€; 

mter.PLFUterLen  »  fptr  -  &filter.Pf_FUter[OJ; 
filter,Pf_Priority  =  1; 

if  (nioctl(fd,  NIOSETF,  (char*)&mter)  <  0) 
return  -1  to  caller; 


/•  binding  */ 

invoke  strncpy  (ifr.ifr.name,  name,  sizeof(ifr.ifr_name)); 

if  (nioctl(fd,  NIOCBIND,  (char*)&ifr)  <  0) 
return  -1  to  caller; 

if  (addressx  is  not  0) 

if  address>>bytes[0]  is  not  set  to  PROMBCUOUS^MODE 

if  ether.cmp(address,  &promiscuous) 

if  MULTICAST  is  not  a  compilation  define  ether.addr 
local.addr; 

if  not  ETHE1C.MCAST  (address) 
close  the  file  descriptior; 
set  ermo  *  EINVAL; 
return  -1  to  caller; 

if  MULTICAST  is  a  compilation  define 
exit  with  -1  for  error; 

else 

if  ^ptr  equals  to  zero 

if  (niocti(fd,  LPUSH,  "pP)  <  0 
return  -1  to  caller; 

fptr  « (unsigned  short  *)  &filter.Pf_Filter[0]; 

if  (t3q>e  does  not  equal  to  ETHER_ALLTYraS  ) 

*^tr++  *  ENF_PUSHWORD  +  ETHEILTYPE/ 
sizeof(short); 

*fptr++  *  ENF+PUSHUT; 

•^tr++  *  htons(  (u_short)  type); 
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•fptr++  -  ENF.CAND; 

/*  compare  the  address  */ 
for  i  <  3 

•^tr++  » (unsigned  short) 

(ENF.PUSHWORD  +  ETHER^DST)  / 
sizeof  (short)  +  i); 

*fptr++  *  (unsigned  short) 

(ENF_PUSHLIT  I  ENF^EQ); 
•fptr++  =  (unsigned  short) 
(address->shorts[i]); 

*fptr++  =  (unsigned  short) 

(ENF.PUSHWORD  +  ETHER.DST  / 
sizeof  (short)  +  i; 

if  SHOW_BCAST  is  a  compilation 
define 

•fptr++  =  (unsigned  short) 

(ENF.PUSHUT  I  ENF.EQ); 
*fptr++  »  (unsigned  short) 

(ether_bcast_addr.shorts(i]); 
•fptr++  =  (unsigned  short)  ENF_OR; 

if  SHOWjrCPlP  is  a  compilation  define 
*fptr++  *  ENF.PUSHUT  I  ENF.EQ; 
else 

•fptr++  *  ENF_PUSHUT  I  ENF.NEQ; 

filter.Pf.FilterLen  »  4^tr  - 
&filter.Pf.Filter(0]; 
filter  J*f.Priority  =  1; 

if  (nioctl  (fd,  NIOCSETF,  (char  •)  &filter)  < 

0) 

return  -1  to  caller; 

if  MULTICAST  is  a  compilation  define 
else 

flag-NI_PROMISC; 
if  (nioctl(fd,  NIOSCFLAGS,  (char  *)  &flag 
<0) 

return  -1  to  caller; 

else  if  in  PROMISCUOUS  MODE 
flag  *  NI_PROMISC; 
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if  (nioctI(fd,  NIOCSFLAGS,  (char*)&flag  < 

0) 

return  -1  to  caller; 

ether.type  » type; 

return  file  descriptorffd)  to  caller; 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  LimitatiQIia-  None 

4.4.1.10  CSU  nioctl 

The  nioctl  CSU  invoke  the  ioctl  function  to  set  the  input/output  control. 


4.4.1.10.1  nioctl  CSU  design  requirements. 

This  CSU  satisfies  intemaUy  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.1.10.2  nioctl  CSU  design. 

The  information  identified  below  represents  the  detailed  design  of  the  nioctl 
CSU. 

Syntax  of  invoking  this  CSU: 
nioctl  (fd,  cmd,  ptr); 

a.  Input /output  data  elements. 

INPUTS: 

"fd"  is  an  integer  stora^  containing  the  file  descriptor  of  to  set 
I/O  control  on. 

"cmd"  is  an  integer  storage  containing  the  I/O  control  command 
value. 

"ptr"  is  a  character  pointer  containing  the  address  of  a  ifconf 
structure  type. 

OUTPUTS:  None. 
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b.  Local  data  elements.  None 

c  Interrupts  and,  signals.  None 

d  Algorithms.  None 

e.  Error  handling. 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

Data  elements: 

None 

Library  routines: 
ioctl 
close 

eSUs: 

None 

h.  Logic  flow. 

invoke  ioctl  with  input  id,  cmd,  ptr; 
if  ioctl  return  <  0 
close  fd; 

return  •!  to  caller; 
return  zero  to  caller; 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations-  None 


4.4.1.11  eSU  ether.interfaces 

The  ether.interfaces  CSU  returns  an  array  of  strings  each  entry  of  which  is  an 
ethemet  interface  name  valid  for  use  in  etherjopen(). 
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4.4.1.11.1  CSU  ether_interfaces  design  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.1.11.2  CSU  etherjnterfaces  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ether_interfaces  CSU. 

S)mtax  of  invoking  this  CSU: 
ether_interface(); 

a.  Input/output  data  elements. 

INPUTS:  None. 

OUTPUTS: 

"result"  is  a  static  character  pointer  that  points  to  an  array  of  size 
16. 

b.  Local  data  ctemgnts. 

/•  local  global  */ 

"checked"  is  a  static  boolean  character  flag; 

"names"  is  a  static  character  buHer  of  size  256. 

"validnameQ"  is  a  static  character  array  initialized  with  the  first  two 
possible  interface  name  letter  in  a  Sun  workstation  ("le",  "ie", 
"ec",  0} 

"_ether_ifindex[16]"  is  a  short  integer  that  is  used  by  _ether_localif(). 
".ether.ifconT  is  fo  struct  ifconf. 

"cbuf '  is  a  static  char  buffer  of  size[16*sizeof(struct  ifreq); 

/•  local  data  •/ 

"sfd”  is  an  integer  storage  containing  the  file  descriptor. 

"i,j,k4"  are  integer  registers. 

"numinter"  is  an  integer  storage  containing  the  number  of  interface, 
c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 
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f.  Data  conversifw  None 

g.  Usfi  Qf  QthftT  f 

Data  elements: 

None 

Library  routines: 
close 
if-else 
goto 
strcmp 
strncmp 
stmcpy 
for-loop 
ioctl 
sizeof 
socket 
if 

CSUs: 

None 

h.  Logic  flow, 
if  checked  is  true 

return  result  to  caller; 

open  the  socket  by  invoking  sfd  «  socket  (AF_INET,  socK_DGRAM,  0); 
if  sdf  is  less  than  zero 
return  zero  to  caller; 

_ether_ifconf.ifc_len  «  sizeof  (cbuf); 

_ether_ifconf.ifc_buf  ■  cbuf; 

if  (ioctl  (sfd,  SICX:GIFC0NF,  (char*)&ether_ifconf  <  0) 
invoke  close  to  dose  the  file  descriptor; 
return  zero  to  caller; 

ksO; 

numinter  *  _ether_ifconf.ifc_len  /sizeof  (struct  ifreq); 
for  i  <  numinter 
for  i  not  equals  to  zero 
if  (strcmp  i 

Lether_ifconf.ifc_req[il.ifr_name, 
validnameQ],  2) 0) 
forl<k 

if  not  strcmp(result[l], 

_ether_ifctmf.  ifc.req(i].ifr.name) 

.ether JfindexP]  *  i; 
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goto  duplicate; 
stmcpy(name  +  16  *  k, 

_ether_ifconf.ifc_req[i].ifr_name, 

IFNAMSIZ); 

result[k]  «  names  -t- 16  *  k; 
if  _ether_ifconf.ifc_req(i].ifr_addr. 
sa.family  equals  to  AF^INET) 
_ether„ifindex[kl  ■  i; 
else 

_ether_ifindex[kl «  -1; 

++k; 

duplicate: 

append  zero  to  result; 
close  sfd; 

set  checked  flag  to  one; 

return  interface  name  result  to  caller; 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations-  None 


4.4.1.12  CSU  8hutdown.SIM_rx 

The  shutdown_SIM.rx  CSU  displays  an  error  message  based  on  the  input 
shutdown  code  and  dose  the  SI^rx.etherFd. 


4.4.1.12.1  CSU  shatdown.SIM_fx  design  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine>interface  (MMI)  and 
system  beha'^/ior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.1.12J1  CSU  shutdown_SIM_rx  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
shutdown_SIM_rx  CSU. 

S3mtax  of  invoking  this  CSU: 

shutdown_SIM_rx(  shutdown.code); 
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a.  InPUt/outnut  data 
INPUTS: 

’’shutdown_code"  is  an  integer  value  containing  the  shutdoivn 
code. 

OUTPUTS:  None. 

b.  Local  data  elempnts. 

c.  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling. 

f.  Data  conyprsion  None 

g.  Use  of  other  elements 
Data  elements: 

SIM_rx_etherFd 
Library  routines: 
perror 
printf 

eSUs: 

None 

h.  Logic  flow, 
switch  (shutdown^code) 

case  0  or  1 

displays  "Error  opening  stream:"; 
case2 

displays  "can't  receive  data  frame  message  from 

Ethernet"; 
case3 

displays  "Only  LLQSNAP)  header  is  read,  no  other 

data" 
default 

displays  "invalid  shutdown  code" 

close  SIM_rx_etherFd; 
return  to  caller; 

i.  Data  stnicturps.  None 
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j.  Local  data  files  or  database.  None 

k.  LimitaHons.  None 

4.4.1.13  CSU  dmsinit 
refer  to  section  4.3.1 

4.4.1.14  CSU  dma.bcopy 
refer  to  section  4.3.7 

4.4J1  Sub-Level  CSC  dmcc.sim_tx.c. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
sim  tx  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU’s  of  this  Sub- 
level  CSC. 

The  following  diagram  depicts  the  overall  structure  of  the  dmcc.siiiL.tx 
Sublevel  CSC. 
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Figure  10  Sublevel  CSU  dmcc.sim_tx  Structure 
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4.4  2.1  CSU  main 

Tht  main  CSU  is  a  driver  for  the  dmcc_sim_tx  function,  gets  Ethernet 
interface  name  from  the  command  line  argument,  calls  routines  to  initialize 
message  queue,  to  gets  pdu  from  message  queue,  and  to  send  pdu  to  a 
message  encode  program. 


4.4.2.1.1  CSU  main  design  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine*interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.4.2.1.2  CSU  main  design. 

The  information  identified  below  represents  the  detailed  design  of  the  main 
CSU. 

Syntax  of  invoking  this  CSU: 
dmcc_sim_tx 

a.  Input/output  data  elements. 

INPUTS: 

"argv"  is  the  command  line  input  argument  containing  the 
Ethernet  interface  name. 

OUTPUTS: 

None. 

b.  Local  data  fiiemfints. 

"i"  is  an  integer  for-loop  counter. 

’l}ufr  is  an  unsigned  character  buffer  of  size  1500  for  holding  the  iiq^ut 
pdu. 

"nbyte.read”  is  an  unsigned  short  integer  storage  containing  the 
number  (rf  byte  read  in  from  the  pdu. 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling- 
display  message  with  printf. 
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Data  elements: 

SIM.interface.name 
Library  routines: 
if  -else 
print! 
bzero 
exit 

while-loop 

CSUs: 

dmsinit 

dms.recvdm 

ALPDU.SIM.encode 

h.  Logic  flow. 

if  command  line  argument  is  less  than  two 
print  the  proper  command  usage; 

else 

get  the  SIMNET  interface  name  hrom  command  line  argument; 
invoke  dmsinit( 

DMS.ENET.TRANSMTT)  to  iiutialize  message 

queue; 

if  dmsinit  return  error 

output  error  message  and  exit; 

while  forever 

invoke  bzero(bu£f,  BUFFJ5IZE)  to  initialize  buff; 

invoke  nbyte^ead  •  dms_recvdm  to  get  input  message 

from  message  queue; 

if  nbyte_t«ad  equals  to  zero 

output  error  message  and  ^t  with  one; 

invoke  ALPDU_SIM_encode(  NEW_ALPDU, 

buff, 

nbyte_read)  to  encode  the  input  pdu; 

i.  Data  structures.  None 


j.  Local  data  files  or  database.  None 

k.  Limitatfons.  None 
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4.4.2^  CSU  ALPDU.SIM.encode 

The  ALPDU_SIM_encode  CSU  prepares  a  PDU  for  transmission  by  adding 
the  Association  Layer  and  sending  the  PDU  to  the  network  interface  routine. 
The  following  paragraphs  privide  design  information  for  this  CSU. 


4.4.2.2.1  CSU  ALPDU_SIM_encode  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.2.2.2  CSU  ALPDU_SIM_encode  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ALPDU.SIM.encode  CSU. 

Syntax  of  invoking  this  CSU: 

ALPDU_SIM_encode( 

unsigned  char  end_ALPDU, 
unsigned  char  •PDU.pkt, 
unsigned  short  PDUjengtti); 

a.  Input/output  data  elements. 

INPUTS: 

"end_ALPDU''is  an  unsigned  character  containing  the 
sequence(type)  of  the  input  pdu^kt; 

"pdu_pkt"  is  a  pointer  to  the  first  word  of  the  buffer  that  is  to  be 
encoded  and  sent  onto  the  network. 

"pdu.lengdi"  is  a  count  of  the  number  of  bytes  in  the  b\iffer. 
OUTPUTS:  None. 

b.  Local  data  elements. 

"i"  is  a  temporary  counter  used  in  various  simple  loops. 

"padding"  is  a  temporary  counter  used  to  in  a  loop  to  fill  the  transmit 
buffer  with  0. 

"offset"  is  a  temporary  variable  used  to  position  data  in  the  transmit 
buffer. 

"ALPDU.kind"  is  an  unsigned  character  storage  containing  the  type  of 
association  pdu. 

"  assoc_PDU"  is  an  AssocPDU_type  pointer  that  points  to  SIM_txbufDD; 
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c. 

d 

e. 

f. 


Interrupts  and  signals.  None. 
Algorithms.  None. 


Error  handling-  None. 
Data  conversion.  None. 


g.  Use  of  other  elements. 
Data  elements: 

SIM_txbufQQ 
SIM_next_frame 
SIM_Assoc_Layer 
Library  routines: 
if-else 
for  -  loop 
if 

CSUs: 

SIM_tx_netif 


h.  Logic  flow. 

if  SIM.Assoc.Layer  is  TRUE 

fill  in  association  layer  information 

/•add  padding  bytes  if  necessary*/ 
if  (padding  -  (PDUJength  %  ASSOC.MULTIPLIER) 
padding  »  ASSCX:_MULTIPLIER  - 
padding; 
for  i  <  padding 

SIM.txbuf[SIM.next_;frame][offeet  + 

PDUJength  +  i]  »  0x00; 

set  assoc_PDU>>DataLength  >  (unsigned  char)  ( (padding 
PDUJength)  / 

ASSOC.MULTIPUER); 

else 

ALPDU  Jdnd  * 

ASSOC.UNKNOWN.KIND; 

offset  *  SNAP_LENGTH  for  SIM_tx_netif()  to 

fill  in; 

for  i  <  PDUJength 

SIM.txbuf[SIM_next.frame][ofiset-fi]  » PDU_pkt[i]; 

set  the  total  pdu  length:  offset  sofiset-t- 
PDUJength; 
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invoke  SIM_tx_netif  to  send  pdu  to  Ethernet  with 
6cSIM_txbuf[SIM.next_frame[0],  offset. 

advance  the  circular  input  storage  index: 

SIM_next_frame  »  (SIM_next_frame  +  1)  % 

MAX.DATAGRAMS; 


return  to  caller; 

i.  Data  structures.  None. 

j.  T  nral  data  files  or  database.  None. 

k.  Limitatiang.  None. 

4.4,23  CSU  SIM_tx_netif 

The  SIM_tx_netif  CSU  allows  association  Protocol  Data  Units  (APDUs)  to  be 
transmitted  onto  the  EtherNet  as  broadcast  messages.  The  calling  fun^on 
spedhes  the  start  address  and  length  of  buffer  to  sent  to  die  Ethmiet  The 
following  paragraphs  privide  design  information  for  this  CSU. 


4.433.1  CSU  SIM.tx.netif  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.233  CSU  SIM.tx.netil  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SIM^tx_netif  CSU. 

a.  Input/output  data  elements. 

INPUTS: 

"pdu.in"  is  an  unsigned  character  pointer  to  the  first  word  of 
the  buffer  that  is  sent  onto  the  network. 

"pdujen"  is  an  unsigned  short  containing  the  number  of  bytes 
in  the  iiqiut  data. 

OUTPUTS:  None. 
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b.  Local  data  glemgnts. 

"i,]**  are  integer  loop  counter. 

"padding"  is  an  integer  storage  containing  the  number  of  bytes  to  be 
padded  with  zero  prior  to  transmission. 

"data.len"  is  an  integer  storage  containing  the  number  of  padding 
bytes  when  multiply  it  by  eight. 

"assoc.data.len"  is  an  integer  storage  containing  the  number  of 
padding  bytes. 

"etherPacket"  is  a  static  ether.packet  storage. 

"sa"  is  a  static  sockaddr  structure. 

"cbuf"  is  a  static  strbuf  structure  contaiiung  the  pdu  control 
information. 

"dbuf '  is  a  static  strbuf  structure  containing  the  pdu  information. 

c.  Interrupts  and  signals.  None. 

d.  Algorithms.  None. 

e  Error  handling.  On  transmission  error,  log  the  error  and  notify 

the  operator. 

f.  Data  conversion. 

Data  elements: 

SIM.tx^etherFd 

SIM.interface.name 

SIM_Assoc_Layer 

SIM_send_frame 

Library  routines: 
if 

perror 
for-loop 
if  -  else 
sizeof 
bcopy 

CSUs: 

ether^open 

logger 

putmsg 


g.  Use  of  other  elements.  Other  elements  that  are  used  by  the 
SIM_tx_netif  CSU:  ether_open,  logger. 

h.  Logic  flow.  Simple  IF  ...  Then ...  Else,  Simple  for  loop. 
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if  (irut_SIM_tx_netif  is  FALSE) 

invoke  ether_open(SIM_interface  name, 

ETHER«ALLTYPES, 

NULL)  to  initialize  the 

Ethernet  interface; 
if  ether.open  returns  <«  zero 
invoke  perror  to  output  error  message; 
invoke  exit  with  one; 

set  buffer  fields  for  sending  Ethernet  frame: 
sa.sa_family  »  AF_UNa*EC: 
cbuf.maxlen  «  cbuf.len  »  sizeof(sa); 
cbuf.buf  =  (char  *)6csa; 

set  init_SIM_tx_netif  to  TRUE; 

set  the  IEEE  802.3  LLC  sublayer  frame  control  header: 

ALPDU.inlO]  =  AA;  -  DSAP 

ALPDUJn(l]  =  AA;  -  SSAP 

ALPDU_in(21 »  0x03;  -  CNTL 

ALPDU_in(31  =  0x080008;  -  Protocol  ID 

AT  PDU.in[6]  =  0x5208;  -  Ether  Type 

if  (p.v.:tr.u  5  s  ASSCX:_PDU.MIN_LEN  - 

ALPDUJen)  >  0 )  padding  requires 
if  SIM_Assoc_Layer  is  TRUE 

append  paddii^  association  layer  at  the  end  of  the  input  pdu: 
1st  byte  of  association  layer  » 

ASSOC_VER_PADKIND; 

2nd  b3rte  of  association  layer  » 
padding/8; 

3rd  byte  of  association  layer  « 

ASSOC.BROADCAST; 

4th  byte  of  association  layer  » 

ASSCX:_SIMULATION; 

5th  to  8th  b3rte  of  association  layer  ^ 

0x00; 

else 

pad  the  association  layer  with  0x00; 

for  j  <  #  of  padding  bytes 
pad  with  0x00; 

ALPDUJen  *  ALPDUJen  +  association  layer's  8  bytes  +  padding  bytes; 
etherPacketLLQen  »  ALPDUJen; 
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etherPacket.pktlen  =  ALPDUJen; 
etherPacket.pktbuf[0]  »  ALPDU_in; 

invoke  bcopy((char*)&etherPacket,  sa.sa.data,  ETHER_HDR_SIZE)  to 
copy  die  Ethernet  header  onto  the  control  buffer; 

set  data  buffer  length  to  be  sent: 

dbuf.len  =  etherPacket.pktlen; 

dbuf.buf  =  (char  *)&etherPacket.pkd>uf[0][0]; 

invoke  putmsg(SIM_tx_etherFd,  &cbuf,  &dbuf,  0)  to  send  Ethernet 
frame  to  STREAM; 
if  putmsg  returns  less  than  zero 

invoke  logger  to  log  TDU^BAD_SENT’; 
invoke  perror  to  output  error  message; 

signal  ALPDU_SIM_encode  that  a  frame  is  sent  by  decrementing 
SIM_send_frame; 

return  to  caller; 

i.  Data  structures.  None. 

j.  Local  data  files  or  database.  None. 

k.  Limitations. 

FUNC  must  be  defined  at  compilation  time. 

MODULE.TEST  must  not  be  deffned  at  compilation  time. 


4.4.2.4  CSU  dmsinit 
refer  to  section  4.3.1 


4.4,2.5  CSU  dms.recvdm 
refer  to  section  4.3.3 


4.4.2.6  CSU  alt_pause 

The  alt.pause  CSU  stops  the  current  process  imtil  a  key  is  struck  ffom  the 
keyboard. 
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4.4.2.6.1  CSU  pause  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.2.6.2  CSU  pause  design. 

The  information  identified  below  represents  the  detailed  design  of  the  paxise 
CSU. 

Syntax  of  invoking  this  CSU: 
alt_pause(); 

a.  Input /output  data  elements. 

INPUTS:  None 
OUTPUTS:  None 

b.  Local  data  elements.  None 

c.  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handUng. 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

Data  elements: 

stdin 

Library  routines: 
printf 
alt_flush 
fflush 
getchar 

CSUs: 

None 

h.  Logic  flow. 

if  #ifdef  ALT.FLUSH  is  defined  as  a  compiler  option 
invoke  alt_flush(stdin)  to  flush  the  standard  input; 
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else  invoke  fflush(stdin)  to  flush  the  standard  input; 

invoke  printf  to  output  the  "pause"  message; 
invoke  getchar; 

if  #ifdef  ALT.FLUSH  is  defined  as  a  compiler  option 
invoke  alt_flush(stdin)  to  flush  the  standard  input; 
else  invoke  fflush(stdin)  to  flush  the  standard  input; 

i.  Data  structures.  None 

j.  Local  data  flips  of  database.  None 

k.  Limitarions.  None 


4.4^7  CSU  alt.flush 

The  alt.flush  CSU  flush  all  typeheads  in  the  input  buffer.  alt_flush  CSU  is 
used  only  if  #ifdef  ALT_FLUSH  is  defined  as  a  compiler  option. 

4.4.2.7.1  CSU  alt.fllu8h  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.4.2.7.2  CSU  alt_flu8h  design. 

The  information  identified  below  represents  the  detailed  design  of  the 

alt_flush  CSU. 

Syntax  of  invoking  this  CSU: 
alt_flush(^); 

a.  Input/output  data  elements. 

INPUTS: 

"fp"  FILE  pointer; 

OUTPUTS: 
return  1. 

b.  Local  data  elements. 
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c  Interrupts  and  signals.  None 

d  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

Data  elements: 

None 

Library  routines: 
getc 
fdopen 
fclose 

CSUs: 

None 

h.  Logic  flOK- 
while  ^>cnt  >  zero 

invoke  getc(^); 
retum(l); 

if  the  compiler  control  line 
#if  constant-expression  evaluates  to  zero 
declare  ^.tmp  as  FILE 

fp_tmp  «  fdopen(fileno(fpL  "r"); 

invoke  fcloseffy)  to  close  the  raiginal  ip  and 

loose  its  buffer; 

set  the  original  ^  »  ^.tmp; 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  T  imitarions.  None 


4.4^  CSU  logger 
referexu:e  to  4.4.1.8 
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4.4i2.9  CSU  ether.opcn 
reference  to  4.4.1.9 


4.4^10  CSU  niocd 
reference  to  4.4.1.10 


4.4^11  CSU  cther.interfaces 
reference  to  4.4.1.11 


4.5  CSC  client 

The  DMCC  Client  CSC  is  an  event  driven,  X-windows  application.  It  uses  the 
OSF  Motif®  graphical  user  interface.  It  contains  hand-coded  C  language 
routines  as  well  as  routiixes  generated  by  a  graphical  user  interface  design 
environment  (GUIDE)  called  Builders  Xcessory,  which  is  published  by 
Integrated  Computer  Solutions,  Incorporated. 

The  client  CSC  manages  the  X-Windows/OSF  Motif®  graphical  irser 
interface.  The  following  diagram  details  the  top  level  structure  of  this  CSC. 

The  client  CSC  contains  the  functionalities  which  satisfy,  in  large  measure, 
the  actual  DMCC  SYstem  Segment  Specification  requirements  3.2.1.2JL2, 
d2.12.23, 32.12.23X  3.Z1.223.2, 32.12233, 32.1223.A  and  3.2. 1.2.235  and 
3.2.1.23.3.6. 
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Figure  11  CSC  Client  Structure  Chart 
4^.1  Sub-Levd  CSC  addrUstCB. 

The  following  paragraphs  tmder  this  section  describe  the  relationship  of  the 
addrUstCB  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSlTs  of  dus 
Sub-level  CSC. 


4,5.1.1  CSUAddrUstAddCB 

The  AddrlistAddCB  CSU  contains  the  callback  for  the  address  list  entry 
screen  add  button.  It  takes  foe  entry  from  the  text  field  and  adds  it  to  the 
address  list 
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43.1.1.1  CSU  AddrListAddCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.1.13  CSU  AddrListAddCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
AddrListAddCB  CSU. 

4.5.1.1.2.1  Tnpiit/output  data  elements. 

INPUTS: 

“w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.1.1.2.2  Local  data  elements. 

"text"  •  contains  the  text  of  the  highlighted  item 
"numitems"  *  contains  the  number  of  items  in  the  list 

4.5.1.1.2.3  Interrupts  and  signals.  None 

4.5.1.1.2.4  Algorithms.  None 

4.5.1.13.5  Error  handling.  None 

4.5.1.13.6  Data  conversion.  None 

4.5.1.13.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  AddrListAddCB  CSU: 

"addrlistlist"  -  widget  id  of  the  address  list 
"addrUstNewItem"  ~  widget  id  of  the  new  address  text  entry  field 
"addrUstAddBtn"  >  widget  id  for  the  add  button  on  the  address  list 
screen 

"addrIistDeleteBtn"  •  widget  id  for  the  delete  button  on  the  address  list 
screen 

"addressList"  *  array  with  all  of  the  entries  in  the  address  list 

4.5.1.13.8  Logic  flow.  Single  pass. 
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4.5.1.1^9  Data  atmCtUKg-  ^k>ne 

4.5.1.12.10  Local  data  fiks  or  databaag.  None 

4.5.1.12.11  Limitarinna  None 


43.12  CSU  AddrLietDdcIcCB 

The  AddrlistDeleteCB  CSU  contains  the  callback  f(»  the  address  list  entry 
screen  delete  button.  It  takes  die  entry  that  is  highlighted  and  deletes  it  horn 
the  address  list. 

43.12.1  CSU  AddilistDeleIcCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  a  helia^ter  mission  equipment  package. 

43.122  CSU  AddrlistDeleteCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 

AddrlistDeleteCB  CSU. 

4.5.1.22.1  Input/output  data  elements. 

INPUTS: 

"w"  ccmtains  widget  id  of  button  pressed 

"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 

OUTPUTS: 

4.5.1.22.2  Local  data  elements. 

"i"  -  counter  for  loop 

"itemNum"  -  die  item  number  from  the  list  to  be  deleted 
"numltons"  -  the  number  of  items  in  the  list 

43.1223  Interrupts  and  signals.  None 

4.5.1.22.4  Algorithms.  None 

43.1.22.5  Error  handling.  None 

43.1.22.6  Data  conversion.  None 
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4.5.1.22.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  AddrListDeleteCB  CSU: 

"addrlistUst"  •  widget  id  of  the  address  list 

"addrListAddBtn"  -  widget  id  f<x  the  add  button  on  the  address  list 
screen 

"addrlistDeleteBtn"  -  widget  id  for  the  delete  button  on  the  address  list 
screen 

"addressList"  •  array  widi  all  the  entries  in  the  address  list 

4.5.1.22.8  Logic  flow.  Single  pass. 

4.5.1.22.9  Data  structures.  None 

4.5.1.2.2.10  Local  data  files  or  database.  None 

4.5.1.2.2.11  Limitations.  None 


4^13  CSU  AddrListSaveExitCB 

The  AddrListSaveExitCB  CSU  handles  the  callback  from  the  Save  and  Exit 
pushbutton.  It  unmanages  the  Address  List  screens  and  remanages  the 
SysMain  screens. 

4.5.13.1  CSU  AddrListSaveExitCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digitad  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.132  CSU  AddrListSaveExitCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
AddrListSaveExitCB  CSU. 

4.5.132.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS: 
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4.5.1.3^.2  Local  data  elements.  None 

4.5.1.3^.3  Interrupts  and  signals.  None 

4.5.1.3.2.4  Algorithms.  None 

4.5.1.3.2.5  Error  handlinf .  Ncme 

4.5.1.3^.6  Data  conversion.  None 

4.5.1.3.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  AddrlistSaveExitCB  CSU: 

4.5.1.3.2.8  Logic  flow.  Single  pass. 

4.5.1.3.2.9  Data  structures.  None 

4.5.1.3.2.10  Local  data  files  or  database.  None 

4.5.1.3.2.11  Limitations.  None 


4.5.1.4  CSU  AddrUstOearExitCB 

The  AddrlistClearExitCB  CSU  handles  the  callback  from  die  Clear  and  Exit 
pushbutton.  It  unnumages  the  Address  List  screens  and  remanages  the 
SysMain  screens. 

4.5.1.4.1  CSU  AddrListQearExitCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  reqturements  to  detail  an 

implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interiace  (MMl)  and 
system  behavior  which  emulate  the  digital  message  commiuiications 
subfunction  of  a  helicopter  mission  equipment  package. 

4J.1.4.2  CSU  AddrListQearExiiCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
AddrlistClearExitCB  CSU. 

4.5.1.4.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  oi  button  pressed 

"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
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OUTPUTS: 


4.5.1.4^.2 


Local  data  elci 


M  W  M  ^ 


Ntme 


4.5.1.4^.3  Interrupts  anH  <iynal«.  None 


4.5.1.4.2.4  Algorithms.  None 

4.5.1.4.2.5  Error  handling.  None 

4.5.1.4.2.6  Data  convgfsion-  None 

4.5.1.4.2.7  Use  of  other  elements.  Other  elements  that  are  tised  by 
the  AddrListClearExitCB  (^U: 


4.5.1.4.2.8  Logic  flow.  Single  pass. 

4.5.1.4.2.9  Data  structures.  None 

4.5.1.4.2.10  Local  data  files  or  database.  None 

4.5.1.4.2.11  Limitations.  None 


4J5,US  CSUPutupAddrUst 

The  PutupAddrlist  CSU  aeates  the  Address  List  entry  screen  if  necessary  aiul 
maitages  the  objects  with  the  first  item  of  die  list  highlighted. 

4.5.15.1  CSU  PutupAddrlist  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Messa^  Communications  System  compliant 
with  customer  directives  to  provide  a  man*machine'interface  (MMl)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

45.155  CSUPutupAddrUst  design. 

The  information  identified  below  mpresents  the  detailed  design  of  the  main 
CSU. 


45.155.1  Input/output  data  elements. 
INPUTS: 
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OUTPUTS: 


4.5.1.5.2.2 

Local  data  elements.  None 

4.5.1.5.2.3 

Interrupts  and  signals.  None 

4.5.1.5.2.4 

Algorithms-  None 

4.5.1.53.5 

Error  handling.  None 

4.5.1.53.6 

Data  conversion. 

4.5.1.53.7 

Use  of  other  elements.  Other  elements  that  are  used  by 

the  PutupAddrUst  CSU: 

"addrlistPorm"  -  widget  id  for  the  address  list  entry  form 
"addrlistTmi"  -  widget  id  for  the  address  list  TMI  form 
"addrlistlist"  -  widget  id  of  the  address  list 

4.5.1.5.2.8  Logic  flow.  Single  pass. 

4.5.1.5.2.9  Data  structures.  None 

4.5.1.5.2.10  Local  data  files  or  database.  None 

4.5.1.5.2.11  Limitations.  None 


4^.2  Sab*Level  CSC  consolcCB. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
consoleCB  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of  this 
Sub-level  CSC. 


43.2.1  CSU  ConsoleSysMainBtnCB 

The  ConsoleSysMainBtnCB  CSU  handles  the  callback  to  from  the  SysMain 
pushbutton.  It  returns  dmcc  to  the  SysMain  screen  at  any  point  during  a 
session. 

433.1.1  CSU  ConsoleSysMainBtnCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Conununications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4.5,2.1,2  CSU  ConsoleSysMainBtnCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ConsoleSysMainBtnCB  CSU. 

4.5.2.1.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS: 


4.5.2.1.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  j'giunents  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
V  4.5.2.1.2.3  Interrupts  and  signals.  None 

4.5.2.1.2.4  Algorithms.  None 


4.5.2.1.2.5  Error  handling.  None 

4.5.2.1.2.6  Data  conversion.  Nozw 


4.5.2.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ConsoleSysMainBtnCB  CSU: 

"tmiScreen"  •  widget  id  which  contains  the  id  of  the  TMI  form 
currently  being  displayed 

"smdScreen"  -  widget  id  which  contains  the  id  of  the  entry  form 
currently  being  displayed 
"dkUbel2"  -  label  of  the  cik2  label 


4.5J2.1.2.8  Logic  flow.  Single  pass. 

4.5.2.1.2.9  Data  structures.  None 
4.52.1.2.10  Local  data  files  or  database.  None 
4.52.12.11  Limitations.  None 
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4.5.3  Sub-Level  CSC  freeTxtCB. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
freeTxtCB  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of  this  Sub- 
level  CSC. 


4.5.3.1  CSU  FreeTxtSendCB 

The  FreeTxtSendCB  CSU  handles  the  callback  from  both  the  Send  Urgent  and 
the  Send  Routine  pushbuttons.  It  retrieves  the  data  from  the  text  entry  area 
and  the  aimotation  area  and  retrieves  the  address  from  the  address  selection 
menu.  It  then  sends  the  data  to  bldFreeText  to  be  sent  out.  It  also  handles  the 
ca^  that  the  message  is  a  reply  by  fixing  the  address  to  that  from  the  message 
being  replied  to.  If  the  message  is  a  Reuse  and  Include,  the  included  message 
will  also  be  sent  to  the  address  selected. 

4.5.3.1.1  CSU  FreeTxtSendCB  requirements. 

The  FreeTxtSendCB  CSU  satisfies  section  3.2.1.2.2.2.2,  3.2.1.2.2.3.6.1  and 

3.2.1.2.2.3.6.1  of  the  specific  requirments  of  the  DMCC  system. 

4.5.3.1.2  CSU  FreeTxtSendCB  design. 

The  ii\formation  identified  below  represents  the  detailed  desiim  of  the 
FreeTxtSendCB  CSU. 

4.53.1.2.1  InPUt/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 

4.53.1.2.2  Local  data  elements. 

"targetCEOI"  -  the  name  of  the  target  for  the  EMgital  Message 

"text"  -  text  from  the  free  text  window 

"optText"  -  aimotation  text 

"pri"  -  priority  of  the  message 

"nullCW"  null  character 

4.53.13.3  Interrupts  and  signals.  None 

4.53.1.2.4  Algorithms.  None 
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4.5.3.1.2.5  Error  handling.  None 

4.5.3.1^.6  Data  conversion.  None 

4.5.3.1.2.7  Use  of  othgr  glcments.  Other  elements  that  are  used  by 
the  FreeTxtSendCB  CSU: 

"FreeTxtAdd"  -  information  on  the  FreeText  address  selection  menu 

"replyFlag"  -  boolean;  is  this  a  reply 

"reuseFlag"  >  boolean;  is  this  a  reuse  and  include 

"replyCEOI"  -  target  name  for  reply  call 

"reusePDU"  -  PDU  to  be  forwarded 

4.53.1^.8  Logic  flow.  Single  pass. 

4.5.3.1.2.9  Data  structures.  None 

4.5.3.1.2.10  Local  data  files  or  database.  None 

4.5.3.1.2.11  Limitations.  None 


4.5.33  CSU  FreeTxtSaveRetum 

The  FreeTxtSaveReturn  CSU  handles  the  callback  from  the  Save  and  Return 
pushbutton.  It  will  unmanage  the  Free  Text  window  and  remanage  the 
Reports  window. 

4.5.33.1  CSU  FreeTxtSaveRetum  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

43333  CSU  FreeTxtSaveRetum  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
FreeTxtSaveRetum  CSU. 

4.53.23.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
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OUTPUTS:  . 


4.53.23.2 

Local  data  elements.  None 

4.53.233 

Interrupts  and  signals.  None 

4.5.3.23.4 

Algoiithmg-  None 

4.53.2.2.5 

Error  handling-  None 

4.53.23.6 

Data  conversion.  None 

4.53.23.7  Use  of  other  elements.  Other  elements  that  are  used  bv 
the  FreeTxtSaveRetum  CSU: 

"freeTxtTmi"  -  widget  id  for  Free  Text  TMI  form 
"freeTxtForm"  -  widget  id  foe  Free  Text  entry  form 

4.53.2.2.8 

Logie  flow.  Single  pass. 

4.53.2.2.9 

Data  structures.  None 

4.5.3.2.2.10 

Local  data  files  or  database.  None 

4.53.23.11 

Limitations.  None 

4.5.3J  CSU  FreeTxtQearRetum 

The  FreeTxtClearRetum  CSU  handles  the  callback  from  the  Qear  and  Return 
pushbutton.  It  will  clear  and  unmanage  the  Free  Text  window  aiul  remanage 
the  Reports  window. 

4.5.33.1  CSU  FreeTxtQearRetum  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5333  CSU  FreeTxtQearRetum  design. 

The  information  identified  below  represents  the  detailed  design  of  the 

FreeTxtClearRetum  CSU. 
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4.53.3.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 

4.5.3.33.2  Local  data  elements.  None 

4.5.3.3.2.3  Interrupts  and  signals.  None 

4.53.3.2.4  Algorithms.  None 

4.53.3.2.5  Error  handling.  None 

4.53.3.2.6  Data  conversion.  None 

4.5.3.33.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  FreeTxtClearRetum  CSU: 

"freeTxtTmi"  -  widget  id  for  Free  Text  TMI  form 
"freeTxtForm"  -  widget  id  for  Free  Text  entry  form 

4.53.33.8  Logic  flow.  Single  pass. 

4.5333.9  Data  structures.  None 

4.5333.10  Local  data  files  or  database.  None 
4.53.33.11  LimitaHons.  None 


4.53.4  CSU  freetxtad.moreCB 

The  freetxtad_inoreCB  CSU  handles  the  callback  from  the  address  more 
button.  It  will  only  function  if  there  are  more  than  4  addresses,  in  which  case 
it  will  show  a  second  bank  of  addresses. 

433.4.1  CSU  freetxtad.moreCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man*machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 
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4.5.3.4.2  CSU  freetxUd.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
freetxtad^moreCB  CSU. 

4.5.3.4.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 


4.53.4.2.2 

Local  data  elements.  None 

4.53.4.23 

Interrupts  and  signals.  None 

4.53.4.2.4 

Algorithms.  None 

4.53.4.2.5 

Error  handling.  None 

4.53.4.2.6 

Data  conversion.  None 

4.53.4.2.7  Use  of  other  elements.  Other  elements  that  are  used  bv 
the  freetxtad_moreCB  CSU: 

"FreeTxtAdd"  *  information  on  the  FreeText  address  selection  menu 

4.5.3.42.8 

Logic  flow.  Single  pass. 

4.53.4.2.9 

Data  structures.  None 

4.53.4.2.10 

Local  data  files  or  database.  None 

4.53.42.11  Limitations.  None 


4.5.3.5  CSU  freetxtad.rotateCB 

The  freetxtad.rotateCB  CSU  handles  the  callback  from  the  address  rotate 
button.  It  will  only  work  if  there  is  more  than  one  address  currently  being 
displayed,  in  which  case  it  will  highlight  the  next  address  in  the  list  or  die 
first  in  the  list  if  the  last  is  currendy  idghlighted. 
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4.5.3.5.1  CSU  freetxtad.rotateCB  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.3.5J2  CSU  freetxtad.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
freetxtad_rotateCB  CSU. 

4.5.3.5.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 


4.5.3.5.2.2 

Local  data  elemente.  None 

4.5.3.5.2.3 

Intermpts  and  signals.  None 

4.53.5.2.4 

Algorithms.  None 

4.53.5.2.5 

Error  handling.  None 

4.53.5.2.6 

Data  conversion.  None 

4.53.5.2.7  Use  of  other  elements.  Other  elements  that  are  used  bv 
the  freetxtad.rotateCB  CSU: 

"FreeTxtAdd"  -  information  on  the  FreeText  address  selection  menu 

4.53.5.2.8 

Logic  flow.  Single  pass. 

4.53.5.2.9 

Data  structures.  None 

4.5.3.5.2.10 

Local  data  files  or  database.  None 

4.53.5.2.11 

Limitations-  None 
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4^3.6  CSU  PutupFrceTxt 

The  PutupFreeTxt  CSU  will  create  the  Free  Text  report  screen  if  necessary  and 
will  also  manage  the  screen. 

4.3.3.6.1  CSU  PutupFreeTxt  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  missitm  equipment  package. 

4.5.3.6J1  CSU  PutupFreeTxt  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
PutupFreeTxt  CSU. 

4.5.3.6.2.1  Input/output  data  elements. 

INPUTS: 


OUTPUTS:  . 


4.53.6.2.2 


Local  data  elei 


MK- 


"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 


"xmstr"  local  to  hold  a  XmString 
"i"  -  coimter 

"entries"  -  number  of  address  entries 


4.53.63.3  Interrupts  and  signals.  None 

4.53.63.4  Algorithms.  None 

4.53.63.5  Error  handling.  None 

4.53.63.6  Data  conversion.  None 

4.53.63.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupFreeTxt  CSU: 

"FreeTxtAdd"  -  information  on  the  FreeText  address  selection  menu 
"freeTxtFbrm"  -  widget  id  for  the  free  text  entry  form 
"addressList"  -  list  of  addresses 
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4.53.6^8  Logic  flow.  ^n^paM. 

4.53.63.9  Data  stnichireg.  None 

4.53.63.10  Toral  filgs  nr  databaaa.  None 

4.53.63.11  Umitations.  None 


433.7  CSU  aearFrccTxt 

The  ClearFreeTxt  CSU  will  clear  all  entries  selected  in  die  Free  Text  report 
433.7.1  CSU  QearFrecTxt  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

433.73  CSU  QearFrecTxt  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
QearFreeTxt  CSU. 

4.53.73.1  Input/output  data  elements. 

INPUTS;  None 

OUTPUTS:  None 

4.53.73.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nullChar"  null  character 

4.53.733  Intemipts  and  signals.  None 

4.53.73.4  Algorithms.  None 

4.53.73.5  Error  handling.  None 

4.53.73.6  Data  conversion.  None 
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4.537^.7  Use  of  other  elements.  elements  that  are  used  by 

the  ClearFreeTxt  CSU: 

"FreeTxtAdd'*  >  information  on  the  FreeText  address  selection  menu 
"textFreeTxt"  -  widget  id  of  text  area  of  Free  Text  screen 

4.53.7.2.8  Logic  flow.  Single  pass. 

4.53.73.9  Data  structures.  None 

4.53.7.2.10  Local  data  files  or  database.  None 

4.53.73.11  Limitations.  None 


4.5.4  Sub>Level  CSC  getMessageCB. 

The  following  paragraphs  tmder  this  section  describe  the  relationship  of  the 
getMessageCB  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU’s  of  this 
Sub-level  CSC. 

4.5.4.1  CSU  getIncomingMsg 

The  getIncomingMsg  CSU  handles  the  receipt  of  any  incoming  message  pdu. 

It  is  called  when  th^  is  a  message  waiting  to  be  read.  It  then  reads  tltf 
message  from  a  pipe  and  processes  it  a<xordingly.  If  it  is  an  acknowledgment, 
it  will  display  a  {x>pup  message  wifli  an  ack  message.  If  the  queue  is  already 
full,  it  will  replace  the  oldest  routine  message  or  oldest  urgent  if  no  routines 
exist.  Otherwise,  it  will  just  place  it  in  the  queue  aiul  update  the  Msgs 
message  list.  It  also  updates  the  numMessages  and  the  numUnread  gldbals. 

43.4.1.1  CSU  getIncomingMsg  nquirements. 

The  getIncomingMsg  CSU  satisfies  section  3.2.1.2.2.1.2,  3.2.1.2.2.1.6; 

3.2.1.2.2.3.4.1  and  3.2.1.2.2.1.63  of  the  spedflc  requirments  of  the  DMCC 
system. 

43.4.13  CSU  getIncomingMsg  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
geflncomingMsg  CSU. 

4.5.4.1.2.1  Input/output  data  elements. 

INPUTS: 

''di_data"  -  client  data 

"sourceFd"  -  pointer  to  a  pipe  file  descriptor 
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"iid"  >  event  handler  call  info 
OUTPUTS:  . 

4.5.4.1J1.2  Local  data  elemgnta. 

"msgLen"  >  lengdi  of  the  PDU  received 
"i"  -  counter 

"readBuf"  -  buffer  read  from  the  pipe  sourceFD 
"pduhdr"-  PDU  header  taken  from  readBuf 
^string"  -  temp  string  to  hold  the  formatted  message  info  striitg 
"messageString"  -  temp  string  to  hold  message  to  be  displayed  upon 
arrival  of  a  message 
"index"  -  index  for  messages 

4.5.4.1^3  Intemipts  and  signals. 

4.5.4.1^.4  Algorithms. 

4.5.4.1.2.5  Error  handling. 

4.5.4.1.2.6  Data  conversion. 

4.5.4.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  getinoomix^Msg  CSU: 

"numMessages"  -  number  of  messages  currently  in  the  message  queue 
"smdPbrm"  *  widget  id  of  the  currently  displayed  entry  form 
"messages"  -  global  queue  containing  messages 
"numUrvead^gs"  •  number  ctf  unread  messages  in  the  queue 
"msgCount"  >  count  of  total  messages 

"msgListInfo"  -  array  containing  the  mail  box  headers  for  all  the 
messages 

4.5.4.12.8  Logic  flow.  Single  pass. 

4.5.4.12.9  Data  structures. 


45.4.12.10 


4.5.4.12.11  Limitations. 


45.5  Sub-Level  CSC  groupUstCB. 

The  following  paragraphs  under  dtis  section  describe  the  relationship  of  the 
groupListCB  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of  dus 
Sub-level  CSC. 
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4.5^5.!  CSU  GrpListAddCB  requirements. 

The  GrpListAddCB  CSU  contains  the  callback  for  the  group  list  entry  screen 
add  button.  It  takes  the  entry  horn  the  text  field  and  adds  it  to  the  group  list 

4.5.5.1.1  CSU  GrpListAddCB  design  specification/constraints. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.5.1.2  CSU  GrpListAddCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
GrpListAddCB  CSU. 

4.5.5.1.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  None 

4.5.5.1.2.2  Lflcal  data.elemfints- 

"text"  *  contains  the  text  of  the  highlighted  item 
"numitems"  -  contains  the  number  of  items  in  the  list 

4.5.5.1.2.3  Interrupts  and  signals.  None 

4.5.5.1.2.4  Algorithms.  None 

4.5.5.1.2.5  Error  handling.  None 

4.5.5.1.2.6  Data  conversion.  None 

4.5.5.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  GrpListAddCB  CSU: 

"grpListlist"  -  widget  id  of  the  grpess  list 
"grpUstNewItem"  -  widget  id  of  the  new  grpess  text  entry  field 
"grpListAddBtn"  -  widget  id  for  the  add  button  on  the  grpess  list  screen 
"grpListDeleteBtn"  -  widget  id  for  the  delete  button  on  the  grpess  list 
screen 

"grpessList"  -  array  with  all  of  the  entries  in  the  grpess  list 
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4.53.1^8  Logic  flow.  Single  pass. 


4.55.1.2.9 

4.5.5.1.2.10 

4.55.1.2.11 


Data  structures.  None 

Local  data  files  or  database.  None 


Limitatinm.  None 


4.5.5 CSU  GrpListDeleteCB 

The  GrpListDeleteCB  CSU  contains  the  callback  for  the  group  list  entry  screen 
delete  button.  It  takes  the  entry  duit  is  highlighted  and  deletes  it  from  the 
group  list. 

45.5JL1  CSU  GrpListDeleteCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  commuiucations 
subfimction  of  a  helicopter  mission  equipment  package. 

45.5.2.2  CSU  GrpListDeleteCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
GrpListDeleteCB  CSU. 

4.55.22.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS: 

4.55.22.2  Local  data  elements. 

"i"  -  counter  for  loq> 

"itemNum"  -  the  item  number  from  the  list  to  be  deleted 
"numitems"  -  the  number  of  items  in  die  list 

4.5.5.22.3  Interrupts  and  signals.  None 

4.55.22.4  Algorithms.  None 
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4.55^^.5  Error  handhng.  None 


4.55.2^.6 


asm.  None 


4.5.5.2^.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  GrpListDeleteCB  CSU: 

"grpListlist"  -  widget  id  of  die  grpess  list 

"grpListAddBtn"  •  widget  id  for  the  add  button  on  die  grpess  list  screen 
"grpUstDeleteBtn"  -  widget  id  for  the  delete  button  on  the  grpess  list 
screen 

"grpessList"  -  array  with  all  of  the  entries  in  die  grpess  list 
4.55.2.2.8  Logic  flow.  Single  pass. 


4.55.2.2.9 


4.5.5.2.2.10 


s.  None 


^  None 


4.5.5.2.2.11  Limitations.  None 


4.5.55  CSU  GrpListSaveExitCB 

The  GrpListSaveExitCB  CSU  handles  the  callback  frmn  die  Save  and  Exit 
pushbutton.  It  unmanages  the  Group  list  screens  and  remanages  the 
SysMain  screens. 

45.55.1  CSU  GrpListSaveExitCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine'interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

45.555  CSU  GrpIistSaveEjdtCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
GrpListSaveExitCB  CSU. 


4.55.35.1 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
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OUTPUTS: 

4.5.5.3^.2  Local  data  elements.  None 

4.5.5.3.23  Interrupts  and  signals.  None 

4.5.5.3.2.4  Algorithms.  None 

4.5.5.33.5  Error  handling.  None 

4.53.3.2.6  Data  conversion.  None 

4.5.5.33.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  GrpListSaveExitCB  CSU: 

4.5.5.33.8  Logic  floW.  Single  pass. 

4.5.5.33.9  Data  structures.  None 

4.5.5.33.10  Local  data  files  or  database.  None 
4.53.33.11  Limitations.  None 


4.5.5.4  CSU  GrpUstClearExitCB 

The  GrpListQearExitCB  CSU  handles  d\e  callback  from  the  Qear  and  Exit 
pushbuttoa  It  unmanages  the  Group  List  screens  and  remanages  the 
SysMain  screens. 

4.5.5.4.1  CSU  GrpListQearExitCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

43.5.43  CSU  GrpListQearExitCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
GrpListClearExitCB  CSU. 


4.5.5.43.1 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
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"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS: 


4.5.5.4.2.2 

Local  data  elements.  None 

4.55.4.2.3 

Interrupts  and  signals.  None 

4.5.5.4.2.4 

Algorithms.  None 

4.55.4.2.5 

Error  handling.  None 

4.5.5.4.2.6 

Data  conversion.  None 

455.4.2.7  Use  of  other  elements.  Other  elements  that  are  used  bv 
the  GrpListClearExitCB  CBU: 

45.5.4.2.8 

Logic  flow.  Single  pass. 

4.5.5.4.2.9 

Data  structures.  None 

4.5.5.4.2.10 

Local  data  files  or  database.  None 

4.5.5.4.2.11 

Limitations.  None 

4.5.5.5  CSU  PutupGroupList 

The  PutupGroupList  CSU  aeates  the  Group  List  entry  screen  if  necessary  and 
manages  the  objects  with  the  first  item  of  the  list  hig^ghted. 

4.5.5^.!  CSU  PutupGroupList  design  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.5.5.2  CSU  PutupGroupList  design. 

The  information  identified  below  represents  the  detailed  design  of  the  main 
CSU. 
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4.5.5.5^.1  Input/output  data  elements. 

INPUTS: 

OUTPUTS: 

4.55.5.2.2  Local  data  elements.  None 

4.5.5.5.2.3  Interrupts  and  signals.  None 

4.5.5.5.2.4  Algorithms.  None 

4.5.5.5.2.5  Error  handling.  None 

4.5.5.5.2.6  Data  conversion. 

4.5.5.5.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupGroupList  CSU: 

"grpListFoim"  -  widget  id  for  the  grpess  list  entry  form 
"grpListTmi"  •  widget  id  for  the  grpess  list  TMI  form 
"grpListlist"  >  widget  id  of  the  grpess  list 

4.5.5.5.2.8  Logic  flow.  Single  pass. 

4.55.5.2.9  Data  structures.  None 

4.5.5.5.2.10  Local  data  files  or  database.  None 

4.5.5.5.2.11  Limitations.  None 

4.5.6  Sub-Level  CSC  listUtiUdes. 

The  following  paragraphs  imder  this  section  describe  the  relationship  of  the 
listUtilities  SuI>Level  CSC  in  terms  of  data  flow  between  the  CSUs  of  dus 
Sub-level  CSC. 

4.5.6.1  CSUUstUpCB 

The  ListUpCB  CSU  handles  the  callback  from  the  Up  pushbutton.  It  changes 
the  highlighted  entry  to  be  the  previous  item  on  the  list  or  the  last  item  on 
the  list  if  the  first  item  is  currently  highlighted. 
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4.5.6.1.1  CSU  ListUpCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.6.1J2  CSU  ListUpCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ListUpCB  CSU. 

4.5.6.1.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  the  list  widget  to  manipulate 
"call"  contains  X  Windows  data  about  tl^  call  reason 

OUTPUTS:  None 

4.5.6.1.2.2  Local-data,  elements. 

"pos"  -  the  position  in  the  list  widget  of  the  hi^ghted  item 
"count"  -  the  number  of  items  higUghted 
"list"  -  widget  id  of  the  list  widget  to  be  rotated 


4.5.6.1.2.3 

Interrupts  and  signals.  None 

4.5.6.1.2.4 

Algorithms.  None 

4.5.6.1.2.5 

Error  handling.  None 

4.5.6.1.2.6 

Data  conversion.  None 

4.5.6.1^.7  Use  of  other  elements.  Other  elements  that  are  used  bv 
the  UstUpCB  CSU: 

4.5.6.1.2.8 

Logic  flow.  Single  pass. 

4.5.6.1.2.9 

Data  structures.  None 

4.5.6.1.2.10 

Local  data  files  or  database.  None 

4.5.6.1.2.11  Limitations.  None 
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4.5.6^  CSU  ListDownCB 

The  ListDownCB  CSU  handles  the  callback  from  the  Down  pushbutton.  It 
changes  the  highlighted  entry  to  be  the  next  item  on  the  list  or  the  first  item 
on  the  list  if  the  last  item  is  currently  highlighted. 

4.5.6^!  CSU  ListDownCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
impleme  itation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.6.2.2  CSU  ListDownCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ListDownCB  CSU. 

4.5.6.2.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  the  list  widget  to  manipulate 
"call"  contains  X  Windows  data  about  the  caU  reason 

OUTPUTS:  None 

4.5.6.2.2.2  Local  data  elements. 

"pos"  -  the  position  in  the  list  widget  of  the  higlighted  item 
"count"  -  the  number  of  items  higlighted 
"list"  -  widget  id  of  the  list  widget  to  be  rotated 
"numitems"  -  the  total  number  of  items  in  the  list 


4.5.6.2.2.3 

Interrupts  and  signals.  None 

4.5.6.2.2.4 

Algorithms.  None 

4.5.6.2.2.5 

Error  handling.  None 

4.5.6.2.2.6 

Data  conversion.  None 

4.5.6.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ListDownCB  CSU: 

4.5.6.2.2.8 

Logic  flow.  Single  pass. 
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4.5.6.2^.9  Data  structures.  None 
4.5.6.2^.10  Local  data  files  or  databaae.  None 
4.5.6.2^.11  Limitationa.  Nm 


4.5.63  CSU  ListAddltem 

The  ListAddltem  CSU  adds  a  given  item  into  a  given  list  widget.  It  adds  die 
item  to  the  end  of  the  list.  It  checks  to  make  sure  the  string  is  not  empty. 

4.5.63.1  CSU  ListAddltem  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.63.2  CSU  ListAddltem  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ListAddltem  CSU. 

4.5.6.33.1  Input/output  data  elements. 

INPUTS: 

'^list"  >  widget  id  of  the  list  the  item  is  to  be  added  to 
"textitem"  -  widget  id  of  the  text  field  die  string  to  be  added  is  to 
be  taken  from 

"addWidget"  -  widget  id  of  the  add  entry  pushbutton 
"delWidget"  >  widget  id  of  the  delete  entry  pushbutton 
"maxitems"  -  maximum  number  of  items  allowed  in  the  list 

OUTPUTS: 

"text"  >  the  text  added  to  die  list 

4.5.6.33.2  Local  data  elements. 

"text"  -  text  to  be  added  to  the  list 

"tempText"  -  temporary  string  holding  the  text  to  be  added  to  die  list 
"nullChar"  -  empty  strii^ 

"numitems"  -  the  total  number  of  items  in  the  list 

4.5.6.33.3  Interrupts  and  signals.  None 

4.5.6.33.4  Algorithms.  None 
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4.5.6.3^5  Error  handling.  The  routine  makes  sure  duit  the  string  is 
not  empty. 

4.5.6.3.2.6  Data  conversion.  None 

4.5.6.3.2.7  Use  of  other  elements.  Other  elemente  that  are  used  by 
the  UstAddItem  CSU: 

4.5.632.8  Logic  flow.  Single  pass. 

4.5.6.3.2.9  Data  structures.  None 

4.5.6.32.10  Local  data  files  or  database.  None 

4.5.6.32.11  Limitarions.  None 


4.5.6.4  CSU  ListDeleteltem 

The  ListDeleteltem  CSU  deletes  the  highlighted  item  from  a  list  widget. 
4.5.6.4.1  CSU  ListDeleteltem  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.6.42  CSU  ListDeleteltem  design. 

The  iitformation  identified  below  represents  the  detailed  design  of  the 
ListDeleteltem  CSU. 

4.5.6.42.1  Input/output  data  elements. 

INPUTS: 

'list"  -  widget  id  of  the  list  the  item  is  to  be  added  to 
"addWidget"  -  widget  id  of  the  add  entry  pushbutton 
"delWidget"  -  widget  id  of  the  delete  entry  pushbutton 

OUTPUTS: 

"deletedPos"  -  position  of  item  deleted  fiom  the  list 
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4.5.6.4^2  Local  data  elements. 

"pos"  -  position  of  item  higfUighted 
"count''  -  number  of  items  highlighted 
"deletedPos"  •  position  <d  item  ddeted 
"numitems"  •  ^  total  number  of  items  in  the  list 


4.5.6.4.2.3  Interrupts  anri  siynaU.  None 

4.5.6.42.4  Algorithms.  None 


4.5.6.42.5  F.rmr  handling.  None 

4.5.6.42.6  Data  conversion.  None 

4.5.6.42.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  listDeleteltem  CSU: 


4.5.6.4.2.8  Logic  flow.  Single  pass. 

4.5.6.4.2.9  Data  structures.  None 

4.5.6.42.10  LocaLdatafiles  or  .database.  None 

4.5.6.42.11  Limitations.  NoiK 


4^7  Sub-Level  CSC  locUstCB. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
locListCB  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of  dus  Sub- 
level  CSC. 

43.7.1  CSU  LocListAddCB 

The  LocListAddCB  CSU  contains  ihe  callback  for  the  location  list  entry  screen 
add  button.  It  takes  dw  entry  from  the  text  field  and  adds  it  to  die  location 
list. 


43  7.1.1  CSU  LocListAddCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package- 
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4^7.12  CSU  LocListAddCB  dc^gn. 

The  information  identified  below  represents  the  detailed  design  of  the 
LocListAddCB  CSU. 

4.5.7.1.2.1  Input /output  data  elements. 


INPUTS: 

"w"  contains  widget  id  oi  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 

OUTPUTS:  None 

4.5.7.1.2.2  Local  data  elements. 

"text"  -  contains  the  text  of  the  highlighted  item 
"numitems"  •  contains  the  number  of  items  in  the  list 


4.5.7.1.2.3 


None 


4.5.7.1.2.4  Algorithms.  None 


4.5.7.1.2.5 

4.5.7.1.2.6 


ling.  Noiw 
irsion.  None 


4.5.7.12.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  LocListAddCB  CSU: 

"locListList"  -  widget  id  of  the  lo(»ss  list 
"locListNewItem"  -  widget  id  of  the  new  locess  text  entry  field 
"locListAddBtn"  -  widget  id  for  the  add  button  on  the  locess  list  screen 
"locListDeleteBtn"  -  widget  id  for  the  delete  button  on  the  locess  list 
screen 

"locessList"  -  array  with  all  of  the  entries  in  the  locess  list 

4.5.7.12.8  Logic  flow.  Single  pass. 


4.5.7.12.9 


5.  None 


4.5.7.12.10 


1.  None 


4.5.7.1.2.11  Limitations.  Noiw 
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4^7 CSU  LocListDeletcCB 

The  LocListDeletcCB  CSU  contains  the  callback  for  tiie  location  list  en^ 
screen  delete  button.  It  takes  the  entry  that  is  highlighted  and  deletes  it  from 
the  location  list. 

4.5.7.2.1  CSU  LocListDeletcCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  commumcations 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.7.2.2  CSU  LocListDeletcCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
LocListDeleteCB  CSU. 


4.5.7.2.2.1 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
''client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS: 


4.5.7.2.2.2 


"i"  -  counter  for  loop 

"itemNum"  -  the  item  number  from  the  list  to  be  deleted 


"numltems"  -  the  number  of  items  in  the  list 


4.5.7.2.2.3  Interrupts  and  signals.  None 

4.5.7.2.2.4  Algorithms.  None 


4.5.7.2.2.5 


None 


4.5.7.2.2.6 


None 


4.5.7.2.2.7  Use  of  other  elements.  Other  dements  that  are  used  by 
the  LocListDeleteCB  CSU: 

"loclistList"  -  widget  id  of  the  locess  list 

"locListAddBtn"  -  widget  id  for  the  add  button  on  the  loc»ss  list  screen 
"locUstDeleteBtn"  -  widget  id  for  the  delete  button  on  the  locess  list 
screen 
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"locessList"  -  array  with  all  of  the  entries  in  ttte  locess  list 
4.5.7.2^8  Lope  flow.  Single  pass. 


4.5.7.2.2.9 


5.  None 


4.5.7.2.2.10 


^  None 


4.5.7.2.2.11  Limitations.  None 


4.5.73 


eSU  LocListSaveExitCB 


The  LocListSaveExitCB  CSU  handles  the  callback  from  the  Save  and  Exit 
pushbutton.  It  unmanages  the  Locatitm  List  screens  aiul  remanages  the 
SysMain  screens. 

4.5.73.1  CSU  LocListSaveExitCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.733  CSU  LocListSaveExitCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
LocListSaveExitCB  CSU. 

4.5.7.33.1  Input/outPut  data  elements. 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS: 


4.5.73.2.2 


None 


4.5.733.3 


None 


4.5.7.33.4  Algorithms.  None 


4.5.733.5 


None 
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4.5.732.6  Data  conversion.  None 

4.5.7.3^.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  LocListSaveExitCB  CSU: 

4.5.7.3.2.8  Logic  flOW-  Single  pass. 

4.5.7.3.2.9  Data  structures.  None 

4.5.7.3.2.10  Local  data  files  or  database.  None 

4.5.7.3.2.11  Limitations.  None 


4.5.7.4  CSU  LocUstClearExitCB . 

The  LocListSaveExitCB  CSU  handles  the  callback  from  the  Save  and  Exit 
pushbutton.  It  unmanages  the  Locaticm  List  screens  and  remaiuiges  the 
SysMain  screens. 

4.5.7.4.1  CSU  LocListQearExitCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.7.4.2  CSU  LocListQearExitCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
LocUstClearExitCB  CSU. 

4.5.7.42.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.7.42.2  Local  data  elements.  None 

4.5.7.4.2.3  Interrupts  and  signals.  None 

4.5.7.42.4  Algorithms.  None 
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4.5.7.42.5  Error  handling.  None 

4.5.7.42.6  Data  conversion.  None 

4.5.7.42.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  LocListClearExitCB  CSU: 

4.5.7.42.8  Logic  flow.  Single  pass. 

4.5.7.42.9  Data  structures.  None 

4.5.7.4.2.10  Local  data  files  or  database.  None 

4.5.7.4.2.11  Limitatjons-  None 

4.5.7.5  CSU  PutupLocationList . 

The  PutupLocationList  CSU  creates  the  Location  List  entry  screen  if  necessary 
and  manages  the  objects  with  the  fiist  item  of  the  list  highlighted. 

4.5.7.5.1  CSU  PutupLocationList  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communicatioits  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.7.52  CSU  PutupLocationList  desigiu 

The  information  identified  below  represents  the  detailed  design  of  the  main 
CSU. 

4.5.7.52.1  Input/output  data  elements. 

INPUTS: 

OUTPUTS: 

4.5.7.52.2  Locational  data  elements.  None 

4.5.7.52.3  Interrupts  and  signals.  None 

4.5.7.52.4  Algorithms.  None 
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4.5.7.5.2.5  Frmr  handling.  None 

4.5.7.52.6  Data  conversion. 

4.5.7.52.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupLocationlist  CSU: 

"locListForm"  >  widget  id  for  die  locess  list  entry  form 
"locListTmi"  >  widget  id  for  the  locess  list  TMI  form 
"locListList"  -  widget  id  of  the  locess  list 

4.5.7.5.2.8  Logic  flow.  Single  pass. 

4.5.7.52.9  Data  structures.  None 

4.5.7.5.2.10  Locational  data  files  or  database.  None 

4.5.7.5.2.11  Limitations.  None 


4^8  Sub-Level  CSC  logonCB. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
logonCB  Sub-Level  CSC  in  terms  of  date  flow  between  the  CSU's  of  this  Sub- 
level  CSC. 


4.5.8.1  CSU  LogonNetLogonCB 

The  LogonNetLogonCB  CSU  handles  the  callback  for  the  logon  pushbutton. 

It  calls  dmslogin  to  inform  dms  that  it  exists  and  sets  up  the  process  for 
receiving  messages  via  a  pipe. 

4^.8.1.1  CSU  LogonNetLogonCB  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4,5.8.12  CSU  LogonNetLogonCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 

LogonNetLogonCB  CSU. 
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4.5^.1^.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 

OUTPUTS:  None 

4.5.8.12.2  Local  data  elements. 

"exerlD"  •  string  with  the  exercise  id 

"logonName"  -  string  with  logon  name 

"exerlDtemp"  -  temp  widi  integer  version  of  the  exercise  id 

"offeet.file"  -  file  descriptor  for  the  file  containing  the  zulu  time  o^et 


"nullChar" 

-  empty  string 

4.5.8.12.3 

Interrupts  and  signals.  None 

4.5.8.12.4 

Algorithms.  None 

4.5.8.12.5 

Error  handling.  None 

4.5.8.12.6 

Data  conversion.  None 

4.5.8.1.2.7 

Use  of  other  elements.  Other  elements  that  are  used  by 

the  LogonNetLogonCB  CSU: 

"exerlDnum"  -  global  with  the  exercise  ID  number 
"logonNameText"  -  widget  id  of  the  text  field  containing  the  logon 


name 

"exerdselDText"  -  widget  id  of  tltt  text  field  containing  the  exercise  id 
"groupList"  -  global  containing  tlw  CEOI/group  list 
"OFFSET_FILENAME"  -  defira  with  the  luune  of  the  offset  file 
"pipeFD"  *  file  descriptor  of  the  pipe  over  which  messages  will  come  in 
"sysMainButton"  -  widget  id  of  sys  main  pushbutton 
'logonTmi"  •  widget  id  of  the  TMI  area  of  file  logon  screen 
'^ogonForm"  -  widget  id  of  the  entry  aj^a  of  the  logon  screen 

4.5.8.12.8  Logic  flow.  Single  pass. 

4.5.8.12.9  Data  structures.  None 
4.5.8.1.2.10  Local  data  files  or  databasg.  None 
4.5.8.12.11  Limitations.  None 
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4.5.8^  CSU  PutupLogon 

The  PutupLogon  CSU  creates  the  logon  screen  if  necessary  and  manages  the 
objects. 

4.5.8^.!  CSU  PutupLogon  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 

implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.8.2.2  CSU  PutupLogon  design. 

The  iidormation  identified  below  represents  the  detailed  design  of  the 
PutupLogon  CSU. 

4.5.8.2.2.1  Input/output  data  elements. 

INPUTS;  None 
OUTPUTS;  None 


4.5.8.2.2.2 

Local  data  elements.  None 

4.5.8.2.2.3 

Interrupts  and  sigrtals.  None 

4.5.8.2.2.4 

Algorithms.  None 

4.5.8.2.2.5 

Error  handling.  None 

4.5.8.2.2.6 

Data  conversion.  None 

4.5.8.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  bv 
the  PutupLogon  CSU: 

TogonTmi"  -  widget  id  of  the  TMI  area  of  the  logon  screen 

TogonForm"  -  widget  id  of  the  entry  area  of  the  logon  screen 

4.5.8.2.2.8 

Logic  flow.  Single  pass. 

4.5.8.2.2.9 

Data  structures.  None 

4.5.8.2.2.10 

Local  data  files  or  database.  None 

4.5.8.2.2.11 

Limitations.  None 
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4.5.9  Sub-Level  CSC  main. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
main  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of  this  Sub- 
level  CSC. 


4.5.9.1  CSU  main 

The  main  CSU  initializes  the  X  window  client,  all  variables  to  be  used  by  the 
report  menus,  creates  the  toplevel  form  and  goes  into  a  loop  waiting  for  stuff 
to  happen. 


4.5.9.1.1  CSU  main  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  eqtiipment  package. 

4.5.9.1.2  CSU  main  design. 

The  information  identified  below  represents  the  detailed  design  of  the  main 
CSU. 


4.5.9.1.2.1  Input/output  data  elements. 

INPUTS: 

"argc"  -  number  of  arguments 
"argv"  -  array  of  argument  strings 

OUTPUTS:  None 

4.5.9.1.2.2  Local  data  elements. 

"display"  -  the  X  display  being  used 

"argent"  -  keeps  track  of  the  nund>er  of  arguments  set  for  XtSetValues 
"args"  -  the  arguments  set  for  XtSetValues 

"argok"  -  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

4.5.9.1.2.3  Interrupts  and  signals.  None 

4.5.9.1.2.4  Algorithms.  None 

4.5.9.1.2.5  Error  handling.  None 

4.5.9.1.2.6  Data  conversion.  None 
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4.5.9.1^.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  main  CSU: 

"context"  -  X  windows  context  of  the  application 
"numMessages"  -  number  of  messages  in  the  message  queue 
"numUnreadMsgs"  -  number  of  unread  messages  in  the  message 
queue 

"msgCount"  -  how  high  the  messages  can  count 
"AppShell"  -  widget  id  of  the  application  shell 
"ShellOOO"  -  widget  id  of  the  top  level  popup  shell 
"Form"  -  widget  id  of  the  top  level  form 

4.5.9. 1.2.8  Logic  flow.  Single  pass  with  infinite  loop  at  the  eitd. 

4.5.9.1.2.9  Data  structures-  None 

4.5.9.1.2.10  Local  data  files  or  database.  None 

4.5.9.1.2.11  Limitations.  None 


4.5.10  Sub>Level  CSC  movcmdTmi.call 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
movcmdTmi_call  Sub-Level  CSC  in  terms  of  data  flow  betwe^  the  CSU’s  of 
this  Sub-level  CSC. 

4.5.10.1  CSU  MovcmdQearNRetCB 

The  MovcmdClearNRetCB  CSU  handles  the  callback  from  the  Clear  and 
Return  pushbutton.  It  will  clear  and  immanage  the  Movcmd  window  and 
remanage  the  Reports  window. 

4.5.10.1.1  CSU  MovcmdQearNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commuiucations  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.10.1.2  CSU  MovcmdQearNRetCB  design. 

Th  iformation  identified  below  represents  the  detailed  design  of  the 
MovcmdQearNRetCB  CSU. 
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4.5.10.1.2.1  Input/outp-^.  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed. 

"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.10.1.2.2  Local  data  elemeals- 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 


4.5.10.1.2.3 


s.  None 


4.5.10.1.2.4  Algorithms.  None 


4.5.10.1.2.5 


ling.  None 


4.5.10.1.2.6 


non.  None 


4.5.10.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MovcmdClearNRetCB  CSU: 

"MovcmdTmiForm"  -  form  widget  containing  Movemd  TMI 
"MovemdForm"  -  form  widget  containing  Movemd  Entry  area 
"cikLabel2"  -  label  widget 

4.5.10.12.8  Logic  flow.  Single  pass 


4.5.10.1.2.9 


5.  None 


4.5.10.12.10 


».  None 


4.5.10.1.2.11  Limitations-  None 


4.5.102  CSU  MovcmdSaveNRetCB . 

The  MovcmdSaveNRetCB  CSU  handles  the  callback  from  the  Save  and 
Return  pushbutton.  It  will  unmanage  the  Movemd  window  and  remanage 
the  Rep>orts  window. 
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4.5.10^1  CSU  MovcmdSaveNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.5.10.2.2  CSU  MovcmdSaveNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MovcmdSaveNRetCB  CSU. 

4.5.10.2.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.10.2.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nullChar"  null  character 

4.5.10.2.2.3  Interrupts  and  signals.  None 

4.5.10.2.2.4  Algorithms.  None 

4.5.10.2.2.5  Error  handling.  None 

4.5.10.2.2.6  Data  conversion.  None 

4.5.10.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MovcmdSaveNRetCB  CSU: 

"MovcmdTmiForm"  -  form  widget  containing  Movemd  TMI 
"MovemdForm"  -  form  widget  containing  Movemd  Entry  area 
"cikLabel2"  -  label  widget 
"dkLabell"  -  label  widget 

4.5.10.2.2.8  Logic  flow.  Single  pass 
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4.5.10.2.2.9  Data  structures.  None 

4.5.10.2.2.10  Local  data  files  or  database.  None 

4.5.10.2.2.11  Limitations.  None 


4^.103  CSU  MovcmdSndRotttCB 

The  MovcmdSndRoutCB  CSU  handles  the  callback  from  the  Send  Routine 
pushbutton.  It  calls  MovcmdSend  with  priority  ROUTINE. 

4.5.103.1  CSU  MovcmdSndRoutCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.1033  CSU  MovcmdSndRoutCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MovcmdSndRoutCB  CSU. 

4.5.10.3.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.10.33.2  Local  data  elements.  None 

4.5.10.33.3  Interrupts  and  signals.  None 
4.5.1033.4  Algorithms.  Noiw 

4.5.10.33.5  Error  handling.  None 

4.5.10.33.6  Data  conversion.  None 

4.5.10.33.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MovcmdSndRoutCB  CSU: 
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"PRIOWTY.ROUnNE"  -  define  for  priority  message 
4.5.10.3^.8  Logic  flow.  Single  pass 
4.5.10.3^.9  Data  struchires.  None 

4.5.10.3.2.10  Local  data  files  or  database.  None 

4.5.10.3.2.11  Limitations.  None 


4.5.10.4  CSU  MovcmdSend 

The  MovcmdSend  CSU  sends  a  message  with  a  given  priority.  It  retrieves  the 
data  from  the  text  entry  area  and  the  annotation  area  and  retrieves  the 
address  from  the  address  selection  menu.  It  then  sends  the  data  to 
bldMovcmd  to  be  sent  out.  It  also  handles  the  case  duit  die  message  is  a  reply 
by  fbdng  the  address  to  that  from  the  message  being  replied  to.  If  the  message 
is  a  Reuse  and  Include,  the  included  message  will  also  be  sent  to  the  address 
selected. 


4.5.10.4.1  CSU  MovcmdSend  requirements. 

The  MovcmdSend  CSU  satisfies  section  3.2.1.2.2.2.1,  3.2.1.2.2.3.6.1  and 

3.2.1.2.2.3.6.1  of  the  specific  requirments  of  the  DMCC  system. 

4.5.10.4.2  CSU  MovcmdSend  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MovcmdSend  CSU. 

4.5.10.4.2.1  Input/output  data  elements. 

INPUTS: 

"prio"  '  priority  of  the  message  being  sent 

OUTPUTS:  None 

4.5.10.42.2  Local  data  elements. 

"targetCEOI"  *  name  of  user  message  is  being  sent  to 

"aimotation"  '  text  of  annotation  string 

"ObserverLocation"  •  location  of  observer 

"TargetID"  -  ID  of  the  target 

"MoTask"  -  movement  task 

"Who*  -  who  to  move 

"MoWhen"  -  v  ^en  to  move 

"dateString"  -  string  with  date  info 
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"01X3"  -  structure  witti  the  date  info 


4.5.10.423  Interrupts  and  signals.  None 

4.5.10.42.4  Algorithms.  Ncme 

4.5.10.42.5  Error  handhng.  None 

4.5.10.42.6  Data  conversion.  None 


4.5.10.42.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MovcmdSend  CSU: 

"MovcmdAdd"  -  information  on  the  Movcmd  address  selection  menu 

"reply  flag"  -  boolean;  is  this  a  reply 

"replyCEOI"  -  target  name  for  reply  call 

"When"  -  information  on  the  When  selection  menu 

"Task"  -  information  on  the  Task  selection  menu 

"reuseFlag"  -  boolean;  is  this  a  reuse  and  include 


4.5.10.42.8  Logic  flow.  Single  pass 

4.5.10.42.9  Data  structuies.  None 


4.5.10.42.10  Local  data  files  or  database.  None 


4.5.10.42.11  LimitaHons.  NoTie 


4.5.103  CSU  MovcmdSndUfgCB  design  spedfication/constraints. 

The  MovcmdSndUrgCB  CSU  handles  the  callback  from  foe  Send  Urgent 
pushbutton.  It  calls  MovcmdSend  with  priority  URGENT. 

43.103.1  CSU  MovcmdSndUrgCB  requirementss. 

This  CSU  satisfies  intemaUy  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine'intedace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  commiinications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.1032  CSU  MovcmdSndUrgCB  desigiL 

The  information  identified  below  represents  foe  detailed  design  of  foe 
MovcmdSndUrgCB  CSU. 
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4^10.6  CSU  OearMovcmd 

The  OearMovcmd  CSU  dears  all  the  entries  of  the  Movcmd  report 
generation  screen. 

4.5.10.6.1  CSU  OearMovcmd  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 
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4JS.10.6^  CSU  QcarMovcmd  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ClearMovcmd  CSU. 

4.5.10.6.2.1  Input/output  data  elements. 

INPUTS: 


OUTPUTS:  None 
4.5.10.6.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nuUChar"  null  char 


4.5.10.6.2.3  Interrupts  and  signals.  None 

4.5.10.6.2.4  Algorithms.  None 

4.5.10.6.2.5  Error  handling.  None 
4.5.10.62.6  Data  conversion.  None 


4.5.10.6.2.7  Use  of  other  glemcnts.  Other  elements  that  are  used  by 
the  ClearMovcmd  CSU: 

"MovemdAdd"  -  info  on  the  selection  menu  for  the  address 
"EnemyType"  -  info  on  the  selection  menu  for  the  enemy  type 
"EnemyActivity"  >  info  on  the  selection  menu  for  the  enemy 
activity 

"Direc"  -  info  on  the  selection  menu  for  the  direction 
"Obsint"  -  info  on  the  selection  menu  for  the  observer 
intentions 

"SpeedText"  •  widget  id  for  speed  text 
"NumText"  *  widget  id  for  number  text 
"UnitText"  -  widget  id  for  unit  text 
"dkTextl"'  widget  id  for  dkl  text 
"cikText2">  widget  id  for  dk2  text 


4.5.10.62.8  Logic  flow.  Single  pass 
4.5.10.6.2.9  Data  structures.  None 
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4.5.10.6^10  Local  data  files  or  datahaiu*  None 
4.5.10.6.2.11  Limitations.  N<me 


4.5.11  Sub>Level  CSC  movcmd.call. 

The  following  paragraphs  imder  this  section  describe  the  relationship  of  the 
movcmd.call  Sub-Levd  CSC  in  terms  of  data  flow  between  the  CSLTs  of  this 
Sub-level  CSC. 

4.5.11.1  CSU  Ictn.moreCB 

The  Ictn.moreCB  CSU  handles  the  callback  for  the  Ictn  More  pushbutton.  It 
displays  additional  selections  if  they  exist 

4.5.11.1.1  CSU  Ictn.moreCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.11.1Jt  CSU  Ictn.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
lctn_moreCB  CSU. 

4.5.11.12.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.11.12.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  die  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 

4.5.11.12.3  Interrupts  and  signals.  None 


Page  160 


Doaunent  ADST/WDL/TR-93-003036 


March  31, 1993 


4.5.11.12.4  Algorithms.  None 

4.5.11.12.5  Error  handling.  None 

4.5.11.12.6  Data  conversion.  None 

4.5.11.12.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  lctn_moreCB  CSU: 

"Lctn"  -  info  on  Enemy  Activity  selection  menu 

4.5.11.12.8  Logic  flow.  Single  pass 

4.5.11.12.9  Data  structures.  None 

4.5.11.12.10  Local  data  files  or  database.  None 

4.5.11.12.11  Limitations.  None 


4.5.112  CSU  Ictn.rotateCB 

The  ictn_rotateCB  CSU  handles  the  callback  for  the  Ictn  Rotate  pushbutton.  It 
changes  the  currently  selected  entry  to  the  next  entry  (the  first  entry  if  it  is  at 
the  already). 

4.5.112.1  CSU  Ictn.rotateCB  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man*machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  missicm  equipment  package. 

43.1122  CSU  lctn.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
lctn_rotateCB  CSU. 


4.5.11.22.1  Input/output  data  elements. 

INPUTS: 

contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 
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4.5.11.2J:.2  Local  data  elmnents.  None 
4.5.11.2^3  Interrupts  and  signals.  None 

4.5.11.2.2.4  Algorithms.  N<me 

4.5.11.2.2.5  Error  handling.  None 

4.5.11.2.2.6  Data  conversion.  None 

4.5.11.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  lctn_rotateCB  CSU: 

'Xctn"  -  info  on  the  enemy  activity  selection  menu 


4.5.11.23.8  Logic  flow.  Single  pass 

4.5.11.2.2.9  Data  structures.  None 

4.5.11.2.2.10  Local  data  files  or  database.  None 


4.5.11.2.2.11  Limitations.  None 


4.5.113  CSU  task^moreCB 

The  task.moreCB  CSU  handles  the  callback  for  the  task  More  pushbutton.  It 
displays  additional  selections  if  they  exist 

4.5.113.1  CSU  task.moreCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.1133  CSU  task.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
task_moreCB  CSU. 

4.5.11.3.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
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4.5.11.4  CSU  task.roUteCB 

The  task.rotateCB  CSU  handles  the  callback  for  the  task  Rotate  pushbutton. 

It  changes  the  currently  selected  entry  to  the  next  entry  (the  first  entry  if  it  is  at 
the  end  already). 

4.5.11.4.1  CSU  task_rotateCB  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfxmction  of  a  helicopter  mission  equipment  package. 
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4.5.11.4^  CSU  task.roUteCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
task^rotateCB  CSU. 

4.5.11.42.1  Input/output  data  glempnts. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 

4.5.11.4.2.2  Local  data  elements.  None 

4.5.11.4.2.3  Interrupts  and  signals.  None 

4.5.11.4.2.4  Algorithms.  None 

4.5.11.4.2.5  Error  handling.  None 

4.5.11.4.2.6  Data  conversion.  None 

4.5.11.4.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  task.rotateCB  CSU: 

"Task"  -  info  on  the  enemy  activity  selection  menu 

4.5.11.4.2.8  Logic  flow.  Single  pass 

4.5.11.4.2.9  Data  structures.  None 

4.5.11.4.2.10  Local  data  files  or  database.  None 

4.5.11.4.2.11  Limitations.  None 

4.5.11.5  CSU  when.rotateCB 

The  when_rotateCB  CSU  handles  the  callback  for  the  when  Rotate 
pushbutton.  It  changes  the  currently  selected  entry  to  the  next  entry  (the  first 
entry  if  it  is  at  the  end  already). 
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4.5.11.5.1  CSU  when.rotateCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.11.5.2  CSU  when.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
when_rotateCB  CSU. 

4.5.11.5.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 

4.5.11.5.2.2  Local  data  elements.  None 

4.5.11.5.2.3  Interrupts  and  signals.  None 

4.5.11.5.2.4  Algorithms.  None 

4.5.11.5.2.5  Error  handling.  None 

4.5.11.5.2.6  Data  conversion.  None 

4.5.11.5.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  when_rotateCB  CSU: 

"When"  -  info  on  the  enemy  activity  selection  menu 
4.5.11.52.8  Logic  flow.  Single  pass 

4.5.11.5.2.9  Data  structures.  None 

4.5.11.5.2.10  Local  data  files  or  database.  None 

4.5.11.5.2.11  Limitations.  None 
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4.5.11.6  CSU  movcmdad.moreCB 

The  movcmdad.moreCB  CSU  handies  the  callback  for  the  movcmdad  More 
pushbutton.  It  displays  additional  selections  if  they  exist. 

4.5.11.6.1  CSU  movcmdad.moreCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine*interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.5.11.6.2  CSU  movcmdad.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
movcmdad.moreCB  CSU. 

4.5.11.6.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 


4.5.11.6.2.2  Local  data  elements.  None 

4.5.11.6.2.3  Interrupts  and  signals.  None 

4.5.11.6.2.4  Algorithms.  None 

4.5.11.6.2.5  Error  handUng.  None 


4.5.11.6.2.6  Data  conversion.  None 

4.5.11.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  movcmdad.moreCB  CSU: 

"MovcmdAdd"  -  info  on  the  Movcmd  address  selection  menu 


4.5.11.6.2.8  Logic  flow.  Single  pass 
45.11.6.2.9  Data  structures.  None 
4.5.11.6.2.10  Local  data  files  or  database.  None 
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43.11.6^.11  Limitations.  None 


4J5.11.7  CSU  movcmdad.rotateCB 

The  movcmdad.rotateCB  CSU  handles  the  callback  for  the  movcmdad 
Rotate  pushbutton.  It  changes  die  currently  selected  entry  to  the  next  entry 
(the  first  entry  if  it  is  at  the  end  already). 

43.11.7.1  CSU  movcmdad.rotateCB  requirements. 

This  CSU  satisfies  interrudly  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.11.7.2  CSU  movcmdad.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
movcmdad.rotateCB  CSU. 

4.5.11.7J2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  dF  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  . 

4.5.11.7.2.2  Local  data  elements.  None 
4.5.11.723  Interrupts  and  signals.  None 

4.5.11.72.4  Algorithms.  None 

4.5.11.72.5  Error  handling.  None 

43.11.72.6  Data  conversion.  None 

43.11.72.7  Use  of  other  elements.  Other  elements  that  are  used  by 
die  movcmdad_rotateCB  CSU: 

"MovemdAdd"  -  info  on  Nfovcmd  address  selection  menu 

4.5.11.72.8  Logic  flow.  Single  pass 
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4.5.11.7^.9  Data  structures.  None 
4.5.11.7^.10  Local  data  files  or  database.  None 
4.5.11.7.2.11  Limitations.  None 


4^.11.8  CSU  PutupMovcmd 

The  PutupMovcmd  CSU  will  create  die  Movcmd  report  screen  if  necessary 
and  will  dso  manage  the  screen. 

4.5.11A1  CSU  PutupMovcmd  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.11.8.2  CSU  PutupMovcmd  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
PutupMovcmd  CSU. 

4.5.11.8.2.1  Input/output  data  elements. 

INPUTS:  None 

OUTPUTS:  None 

4.5.11.8.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"entries"  -  number  of  addresses 

4.5.11.8.2.3  Interrupts  and  signals.  None 

4.5.11.8.2.4  Algorithms.  N<nie 

4.5.11.8.2.5  Error  handling.  None 

4.5.11.8.2.6  Data  conversion.  None 
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4.5.11.8^.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupMovcmd  CSU: 

"MovcmdFonn"  •  widget  id  of  movcmd  fonn 
'l^vcmdAdd*  -  info  on  Movcmd  address  selection  menu 
"addresslist"  •  list  of  addresses 
'^ovcmdMoreLaber  -  widget  id  of  More  label 
'TdovcmdMoreArrow*  -  widget  id  of  More  arrow 
"replyFlag"  -  bocdean;  is  this  a  reply 
"MovcmdTmiForm"  widget  id  of  movcmd  TMI  form 


4.5.11.8.2.8  Logic  flow.  Single  pass 

4.5.11.8.2.9  Data  structures.  None 

4.5.11.8.2.10  Local  data  files  or  database.  None 

4.5.11.8.2.11  Limitations.  Noiw 


4.5.12  Sub-Level  CSC  msglCB. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
msglCB  Sub-Level  CSC  in  terms  of  data  flow  between  die  CSU's  of  this  Sub- 
level  CSC. 

4.5.12.1  CSU  MsgsPrevCB 

The  MsgsPrevCB  CSU  handles  the  callback  from  die  previous  pushbutton. 
The  previous  message  in  the  list  is  highlighted. 

4.5.12.1.1  CSU  M^PrevCB  requirements. 

The  MsgsPrevCB  CSU  satisfies  section  3.2.1.2.2.3.1.1  of  the  specific 
requirments  of  the  DMCC  system. 

4.5.12.1.2  CSU  MsgsPrevCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgsPrevCB  CSU. 

4.5.12.1.2.1  Input/output  data  elements. 

INPUTS: 

"w"  c<mtains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
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OUTPUTS:  None 

4.5.12.1.2^  Local  data  elements. 

"pos'*  -  position  in  list  highlighted 
"count"  -  number  of  items  highlighted 

4.5.12.12.3  Interrupts  and  signals.  None 

4.5.12.1.2.4  Algorithms.  None 

4.5.12.1.2.5  Error  handUng.  None 
4.5.12.12.6  Data  conversion.  None 

4.5.12.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgsPrevCB  CSU: 

"msglList"  -  widget  id  of  the  msgl  list 

4.5.12.12.8  Logic  flow.  Single  pass. 

4.5.12.1.2.9  Data  structures.  None 

4.5.12.1.2.10  Local  data  files  or  database.  None 
4.5.12.12.11  Limitations.  None 

4.5.122  CSU  MsgsNextCB 

The  MsgsNextCB  CSU  handles  the  callback  from  die  next  pushbutton.  The 
next  message  in  the  list  is  highlighted. 

4.5.122.1  CSU  MsgsNextCB  requirements 

The  MsgsNextCB  CSU  satisfies  section  3.2.1. 2.2.3. 1.1  of  the  specific 
requirments  of  the  DMCC  system. 

AJSA2.2J2  CSU  MsgsNextCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgsNextCB  CSU. 

4.5.1222.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
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"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 

OUTPUTS:  None 

4.5.12.2^.2  Local  data  elements. 

"pos"  -  positi<m  in  list  highlighted 
"count"  -  number  of  items  highlighted 
"numitems"  *  number  of  items  in  the  list 

4.5.12.2.2.3  Interrupts  anH  «ignaU.  None 

4.5.12.2.2.4  Algorithms.  None 

4.5.12.2.2.5  F.rror  handling.  None 

4.5.12.2.2.6  Data  conversion.  None 

4.5.12.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgsNextCB  CSU: 

"msglList"  >  widget  id  of  the  msgl  list 

4.5.12.2.2.8  Logic  flow.  Single  pass. 

4.5.12.22.9  Data  structures.  None 

4.5.12.22.10  Local  data  files  or  database.  None 

4.5.12.22.11  Limitations.  None 

4.5.122  CSU  MsgsReadCB 

The  MsgsReadCB  CSU  handles  the  callback  for  the  Read  pushbutton.  It  brings 
up  a  formatted  version  of  the  currently  higlighted  p>du. 

42.122.1  CSU  MsgsReadCB  requirements 

The  MsgsReadCB  CSU  satisfies  section  3.2.1.2.2.2.3  of  the  specific  requirments 
of  the  DMCC  system. 

4.5.1222  CSU  MsgsReadCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgsReadCB  CSU. 
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4.5.12.3.2.1 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 

OUTPUTS:  None 

4.5.12.3.2.2  Local  data  elements. 

"pos"  -  position  in  list  highlighted 
"count"  -  number  of  items  highlighted 
"msgBuf "  -  message  buffer 


4.5.12.3.2.3 


None 


4.5.12.3.2.4  Algorithms.  None 


4.5.12.3.2.5 


ling.  Ncme 


4.5.12.3.2.6 


I.  None 


4.5.12.3J2.7  ,  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ^gsReadCB  CSU: 

"msglList"  >  widget  id  of  the  msgl  list 
"msglTmi"  -  widget  id  of  the  TMI  of  msgl 
"msglForm"  -  widget  id  of  the  entery  aread  of  msgl 
"messages"  -  queue  with  messages 

"msgUstlndex"  >  array  of  mappings  of  msgl  list  entries  to  messages 
entries 

"numUnreadMsgs"  -  number  of  unread  messages  in  the  queue 
"msgReadText"  -  widget  id  of  read  screen  text 

4.5.12.3.2.8  Logic  flow.  Single  pass. 


4.5.12.32.9 


5.  None 


4.5.1232.10 


i.  Ncrne 


4.5.12.3.2.11  Limitations.  None 


43.12.4  CSUMsgsDeleteCB 

The  MsgsDeleteCB  CSU  handles  the  callback  for  the  Delete  pushbutton.  It 
deletes  the  currently  higlighted  pdu. 
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4.5.12.4.1  CSU  MsgsDeleteCB  requirements. 

The  MsgsE)eleteCB  CSU  satisfies  section  3.2.1.2.2.2.3  and  3.2.1.2.2.3.5.1  of  the 
specific  requirments  of  the  DMCC  system. 

4.5.12.4.2  CSU  MsgsDeleteCB  design* 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgsDeleteCB  CSU. 

4.5.12.4.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.12.4.2.2  Local  data  elements. 

"pos"  -  p)osition  in  list  highlighted 
"count"  -  number  of  items  highlighted 
"numitems"  -  number  of  items  in  the  list 
"i"  -  cotmter 


4.5.12.4.2.3  Interrupts  and  signals.  None 

4.5.12.4.2.4  Algorithms.  None 

4.5.12.4.2.5  Error  handling.  None 


4.5.12.42.6  Data  conversion.  None 

4.5.12.42.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgsDeleteCB  CSU: 

"msglList"  >  widget  id  of  the  msgl  list 

"numUnreadMsgs"  >  number  of  tinread  messages  in  the  queue 
"messages"  -  global  queue  containing  messages 

"msgUstlndex"  -  array  of  mappings  of  msgl  list  entries  to  messages 
entries 

"numMessages"  -  number  of  messages  in  the  queue 


4.5.12.42.8  Logic  flow.  Single  pass. 

4.5.12.42.9  Data  structures.  None 
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4.5.12.4.2.10  Local  data  files  or  database.  None 

4.5.12.4.2.11  Limitations.  None 

4.5.12.5  CSU  FormatMessageInfo 

The  FormatMessageInfo  CSU  takes  information  about  the  message  and 
creates  the  header  string  for  the  Msgl  window. 

4.5.12.5.1  CSU  FormatMessageInfo  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commimications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.12.5.2  CSU  FormatMessageInfo  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
FormatMessageInfo  CSU. 

4.5.12.5.2.1  Input/output  data  elements. 

INPUTS: 

"type"  -  type  of  message 
"sender"  -  seiuler  of  message 
"timeHour"  -  hour  message  sent 
"timeMin"  -  minute  message  sent 
"pri"  -  priority  of  message 

OUTPUTS: 

"info"  -  formatted  string  of  message  information 

4.5.123.2.2  Local  data  elements. 

"info"  -  formatted  string  of  message  information 
"priChar"  -  character  containing  the  priority  of  the  message 

4.5.12.5.2.3  Interrupts  and  signaU.  None 

4.5.12.5.2.4  Algorithms.  None 
4.5.12.52.5  Error  handling.  None 
4.5.12.5.2.6  Data  conversion.  None 
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4.5.12.5.2.7  Use  of  othor  elgmants.  Other  elements  that  are  used  by 
the  FormatMessageInfo  CSU: 

None 

4.5.12.5.2.8  Logic  flow.  Single  pass. 


4.5.12.5.2.9 


i.  None 


4.5.12.5.2.10  Local  data  files  or  di 

4.5.12.5.2.11  Limitations.  None 


>.  None 


4.5.12.6  CSU  PutupMsgl 

The  PutupMsgl  CSU  will  create  the  Msgl  screen  if  necessary  and  will  also 
manage  ^e  screen. 

4.5.12.6.1  CSU  MsgsPrevCB  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.12.6^1  CSU  MsgsPrevCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgsPrevCB  CSU. 

4.5.12.6.2.1  Inout/output  data  elements. 


INPUTS:  None 


OUTPUTS:  None 


4.5.12.6.2.2 


None 


4.5.12.6.13 


None 


4.5.12.61.4  Algorithms.  None 


4.5.12.61.5 


lins.  None 


4.5.12.6.2.6 


None 
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4.5.12.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgsPrevCB  CSU: 

"msglList"  -  widget  id  of  the  msgl  list 
"msglTmi"  -  widget  id  of  the  TMI  of  msgl 
"msglForm"  -  widget  id  of  the  entery  aread  of  msgl 
"smdForm"  -  widget  id  of  the  currently  displayed  entry  form 

4.5.12.6.2.8  Logic  flow.  Single  pass. 

4.5.12.6.2.9  Data  structures.  None 

4.5.12.6.2.10  Local  data  files  or  database  None 

4.5.12.6.2.11  Limitations.  None 


4.5.12.7  CSU  TestPriority 

The  TestPriority  CSU  will  take  two  messages  and  determine  which  one  has 
higher  priority.  Priority  is  determined  by  not  only  the  priority  field,  but  also 
the  timestamp  of  the  message. 

4.5.12.7.1  CSU  TestPriority  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.12.7 CSU  TestPriority  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
TestPriority  CSU. 

4.5.12.7.2.1  Input/output  data  elements. 

INPUTS: 

"indexl"  -  first  index  to  be  tested 
"index2"  -  second  index  to  be  tested 

OUTPUTS: 

"restdt"  -  result  of  the  test 


4.5.12.72.2  Local  data  elements, 
"priol"  -  priority  of  index  1 
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"prio2''  -  priority  of  index  2 
"indl"  -  index  of  index  1 
"ind2''  -  index  of  index  2 

"result"  -  result  of  the  test 

4.5.12.7.2.3  Interrupts  and  signals.  None 

4.5.12.72.4  Algorithms.  None 

4.5.12.7.2.5  Error  handling.  None 

4.5.12.72.6  Data  conversion.  None 

4.5.12.72.7  Usg  of  other  elements.  Other  elements  that  are  used  by 
the  TestPriority  CSU: 

"messages"  -  global  queue  containing  messages 
4.5.12.7.2.8  Logic  flow.  Single  pass. 

4.5.12.72.9  Data  structures.  None 

4.5.12.72.10  Local  data  files  or  database.  None 

4.5.12.72.11  Limitatjons.  None 


4^.12^  CSU  UpdateUst 

The  UpdateUst  CSU  will  update  dte  Msgl  list  widi  any  new  messages  and 
order  the  messages  appropriately. 

4^12^.1  CSU  UpdateList  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.12.82  CSU  UpdateList  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
UpdateList  CSU. 

4.5.12.82.1  Input/output  data  elements. 

INPUTS:  None 


Page  177 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


OUTPUTS:  None 


4.5.12.8.2.2  Local  data  elements. 

"argent"  -  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  -  the  arguments  set  for  XtSetValues 

"argok"  -  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  -  local  to  hold  a  XmString 
"i"  -  counter 

"listEntery"  -  temp  string  carrying  the  msgl  display  info 
"swap"  -  boolean  for  the  sort 
"tmp"  -  a  temp  variable 


4.5.12.8.2.3  Interrupts  and  signals.  None 

4.5.12.8.2.4  Algorithms.  None 

4.5.12.8.2.5  Error  handling.  None 

4.5.12.8.2.6  Data  conversion.  None 


4.5.12.8.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  UpdateUst  CSU: 

"numMessages"  -  number  of  messages  currently  in  the  message  queue 
"msgListInfo"  -  array  containing  the  mail  box  headers  for  all  the 
messages 

"msgListIndex"  >  array  of  mappings  of  msgl  list  entries  to  messages 
entries 


4.5.12.82.8  Logic  flow.  Single  pass. 

4.5.12.82.9  Data  structures.  None 

4.5.12.82.10  Local  data  files  or  database.  None 

4.5.12.82.11  Limitations.  None 


4.5.12.9  CSU  MsgsReuseCB 

The  MsgsReuseCB  CSU  haiulles  the  callback  for  the  Reuse  pushbutton.  It 
saves  the  currently  highlighted  PDU  in  a  global  and  thing  brings  up  the  reuse 
report  screen. 
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4.5.12.9.1  CSU  MsgsRcuseCB  requirements. 

The  MsgsReuseCB  CSU  satisfies  section  3.2.1.2.2.2.3  and  3.2.1. 2.2.3.2.2  of  the 
specific  requirments  of  the  DMCC  system. 

4.5.12.9JZ  CSU  MsgsReuseCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgsReuseCB  CSU. 

4.5.12.9.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  p>ressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.12.9.2.2  Local  data  elements. 

"pos"  •  position  in  list  highlighted 
"count"  •  number  of  items  highlighted 

4.5.12.9.2.3  Interrupts  and  signals.  None 

4.5.12.9.2.4  Algorithms.  None 

4.5.12.9.2.5  Error  handhny.  None 

4.5.12.92.6  Data  conversion.  None 

4.5.12.92.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgsReuseCB  CSU: 

"msglList"  •  widget  id  of  the  msgl  list 
"reusePDU"  >  pdu  to  be  forward^ 

"msglTmi"  •  widget  id  of  TMI  area  of  msgl  form 
"msglForm"  -  widget  id  of  entry  area  of  msgl  form 
"msglistlndex"  •  array  of  mappings  of  msgl  list  entries  to  messages 
entries 


4.5.12.92.8  Logic  flow.  Single  pass. 

4.5.12.92.9  Data  structures.  None 

4.5.12.92.10  Local  data  files  or  database.  None 
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4.5.12.9.2.11  Limitations.  None 


4.5.12.10  CSU  MsgsReuseNIndudeCB 

The  MsgsReuseNIndudeCB  CSU  handles  the  callback  for  the  Reuse  and 
Indude  pushbutton.  It  saves  the  currently  highlighted  PDU  in  a  global  and 
thing  brings  up  the  report  screen  so  that  a  new  report  can  be  generated  for 
indusion  with  the  reused  message. 

4.5.12.10.1  CSU  MsgsReuseNIndudeCB  requirements. 

The  MsgsReuseNIndudeCB  CSU  satisfies  section  3.2.1.2.2.2.3  and  3.2.1.2.2.3.23 
of  the  specific  requirments  of  the  DMCC  system. 

4.5.12.103  CSU  MsgsReuseNIndudeCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgsReuseNIndudeCB  CSU. 

4.5.12.10.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.12.103.2  Local  data  elements. 

"(>os"  -  position  in  list  highli^ted 
"count"  -  number  of  items  highlighted 

4.5.12.103.3  Interrupts  and  signals.  None 

4.5.12.103.4  Algorithms.  None 

4.5.12.103.5  Error  handling.  None 

4.5.12.103.6  Data  conversion.  None 

4.5.12.103.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgsReuseNIndudeCB  CSU: 

"msglList"  >  widget  id  of  the  msgl  list 
"retisePDU"  -  pdu  to  be  forwarded 
"msglTmi"  *  widget  id  of  TMI  area  of  msgl  form 
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"msglForm"  -  widget  id  of  entry  area  of  msgl  fcMrm 
"msglistlndex''  -  array  of  mappings  of  msgl  list  entries  to  messages 
entries 

"reuseFlag"  -  are  we  including  a  message 

4.5.12.10.2.8  Logic  flow.  Single  pass. 

4.5.12.10.2.9  Data  structures.  None 

4.5.12.10.2.10  Local  data  files  or  database.  None 

4.5.12.10.2.11  Limitations.  None 


4.5.12.11  CSU  MsgsSaECB . 

The  MsgsSaECB  CSU  handles  the  callback  from  the  Save  and  Exit  pushbutton. 
It  leaves  the  Msgsl  screen  and  returns  to  the  SysMain  screen. 

4.5.12.11.1  CSU  MsgsSaECB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine*interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.12.11.2  CSU  MsgsSaECB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgsSaECB  CSU. 

4.5.12.11.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.12.11.2.2  Local  data  elements. 

"pos"  -  posititm  in  list  highlighted 
"count"  •  number  of  items  highlighted 

4.5.12.11.2.3  Interrupts  and  signals.  None 
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4.5.12.11.2.4  Algorithms.  None 

4.5.12.11.2.5  Error  handling.  None 

4.5.12.11.2.6  Data  conversion.  None 

4.5.12.11.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgsSaECB  CSU: 

"msglList"  -  widget  id  of  the  msgl  list 
"msglTmi"  -  widget  id  of  TMI  area  of  msgl  form 
"msglForm"  -  widget  id  of  entry  area  of  msgl  form 

4.5.12.11.2.8  Logic  flow.  Single  pass. 

4.5.12.11.2.9  Data  structures.  None 

4.5.12.11.2.10  Local  data  files  or  database.  None 

4.5.12.11.2.11  Limitations.  None 


4.5.12.12  CSU  MsgsReplyCB 

The  MsgsReplyCB  callback  handles  d\e  callback  for  die  Reply  pushbutton.  It 
stores  the  CEOI  of  the  sender  of  the  higlighted  message  arid  dien  brings  up  the 
report  screen  for  a  message  to  be  generate  to  the  sender  of  said  message. 

4.5.12.12.1  CSU  MsgsReplyCB  requirements. 

The  MsgsReplyCB  CSU  satisfies  section  3.2.1.2.2.2.3  of  the  specific  requirments 
of  the  DMCC  system. 

4.5.12.12.2  CSU  MsgsReplyCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgsReplyCB  CSU. 

4.5.12.12.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"*  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 
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4.5.12.12^2  Local  data  elements. 

"pos"  ■  position  in  list  highlighted 
"count"  •  niunber  of  items  highlighted 

4.5.12.12.2.3  Interrupts  and  signals.  None 

4.5.12.12.2.4  Algorithms.  None 
4.5.12.122.5  Error  handling.  Ncme 
4.5.12.12.2.6  Data  conversion.  None 

4.5.12.122.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgsReplyCB  CSU: 

"msglList"  -  widg^  id  tiie  msgl  list 
"replyFlag"  *  is  this  a  reply 
"replyCEOr  -  reply  return  address 
"msglTmi"  >  widget  id  of  TMI  area  of  msgl  form 
"msglForm"  -  widget  id  of  entry  area  of  msgl  form 

4.5.12.122.8  Logic  flow.  Singtepass. 

4.5.12.122.9  Data  structures.  None 

4.5.12.122.10  Local  data  files  or  database.  None 

4.5.12.122.11  Limitations.  None 


4^12.13  CSU  MsgsReporlCB 

The  MsgsReportCB  CSU  handles  the  callback  for  the  Report  pushbutton.  It 
uiunanages  the  Msgsl  screen  and  brings  up  the  Reports  screen. 

4,5.12.13.1  CSU  MsgsReportCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.12.132  CSU  MsgsReportCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgsReportCB  CSU. 
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4.5.12.13^.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  oi  button  pressed 
"client*  contains  client  data 

"call*  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  None 

4.5.12.13.2.2  Local  data  elements.  None 

4.5.12.13.2.3  Interrupts  and  signals.  None 


4.5.12.13.2.4  Algorithms.  None 
4.5.12.13J[.5  Error  handling.  None 

4.5.12.13.2.6  Data  conversion.  None 

4.5.12.13.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgsReportCB  CSU: 

"msglTmi"  •  widget  id  of  TMI  area  of  msgl  form 
"msglForm*  -  widget  id  of  entry  area  of  msgl  form 

4.5.12.132.8  Logic  flow.  Single  pass. 


4.5.12.13.2.9  Data  structures.  None 

4.5.12.132.10  Local  data  files  or  database.  None 

4.5.12.132.11  Limitations.  None 


45.13  Sub>LevelCSC  m^ReadCB. 

The  following  paragraphs  imder  dus  section  describe  the  relationship  of  the 
msgRea<^B  Sub>Level  CSC  in  terms  of  data  flow  between  die  CSU’s  of  this 
Sub-level  CSC. 


4.5.13.1  CSU  MsgReadReadCB 

The  MsgReadReadCB  CSU  handles  the  callback  for  the  Read  pushbutton.  It 
brings  up  the  Msgl  screen. 
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4.5.13.1.1  CSU  MsgReadReadCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.13.1.2  CSU  MsgReadReadCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgReadReadCB  CSU. 

4.5.13.1.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.13.1.2.2  Local  data  elements. 

"nuUChar"  -  empty  string 

4.5.13.1.2.3  Interrupts  and  signals.  None 
4.5.13.12.4  Algorithms.  None 

4.5.13.1.2.5  Error  handling.  None 

4.5.13.1.2.6  Data  conversion.  None 

4.5.13.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgReadReadCB  CSU: 

"msgReadTmi"  -  widget  id  of  TMI  area  of  msgRead  form 
"msgReadForm"  -  widget  id  of  entry  area  of  msgRead  form 
"cikTextl"  -  widget  id  of  CDC  text  1 


4.5.13.12.8  Logic  flow.  Single  pass. 
4.5.13.1.2.9  Data  structures.  None 

4.5.13.12.10  Local  data  files  or  database.  None 

4.5.13.12.11  Limitations.  None 
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4.5.13^  CSU  MsgReadDeleteCB 

The  MsgReadDeleteCB  CSU  handles  the  callback  for  the  Delete  button.  It 
delete  the  message  currently  being  displayed  and  returns  to  the  Msgsl  screen. 

4.5.13.2.1  CSU  MsgReadDeleteCB  requirements. 

The  MsgReadDeleteCB  CSU  satisfies  section  3.2.1.2.2.3.1.2,  3.2.1.2.2.3.5.1  and 

3.2.1.2.2.3.5.2  of  the  spedhc  requirments  of  the  DMCC  system. 

4.5.13.2.2  CSU  MsgReadDeleteCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgReadDeleteCB  CSU. 

4.5.13.2.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.13.22.2  Local  data  elements. 

4.5.13.22.3  Interrupts  and  signals.  None 

4.5.13.22.4  Algorithms.  None 

4.5.13.22.5  Error  handling.  None 

4.5.13.22.6  Data  conversion.  None 

4.5.13.22.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgReadDeleteCB  CSU: 

None 

4.5.13.2.2.8  Logic  flow.  Single  pass. 

4.5.13.2.2.9  Data  structures.  None 

4.5.13.22.10  Local  data  files  or  database.  None 

4.5.13.22.11  Limitations.  None 
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4^133  CSU  PutupMsgRcad . 

The  PutupMsgRead  CSU  will  create  the  MsgRead  screen  if  necessary  and  will 
also  manage  die  screen. 

4.5.133.1  CSU  PutupMsgRead  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.1333  CSU  PutupMsgRead  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
PutupMsgRead  CSU. 

4.5.13.33.1  Input/output  data  elements. 

INPUTS:  None 

OUTPUTS:  None 


4.5.13.33.2  Local  data  elements. 

"argent"  -  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  -  the  arguments  set  for  XtSetValues 

"argok"  -  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  -  local  to  hold  a  XmString 


4.5.1333.3 

4.5.13.33.4 

4.5.1333.5 

4.5.1333.6 

4.5.1333.7 


Interrupts  and  signals.  None 
Algorithms.  None 
Frmr  handling.  None 
Data  conversion.  None 

TJsg  of  othgr  elements.  Other  elements  that  are  used 


the  PutupMsgRead  CSU: 

"msgReadTmi"  -  widget  id  of  TMI  area  of  msgRead  form 
"msgReadFbrm"  -  widget  id  of  entry  area  of  msgRead  hmm 
"smdForm"  -  widget  id  of  the  smd 

"tmiScreen"  -  widget  id  of  current  TMI 


by 
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"smdScreen"  -  widget  id  of  current  entery  screen 

4.5.13.3.2.8  Logic  flow.  Single  pass. 

4.5.13.3.2.9  Data  structures.  None 

4.5.13.3.2.10  Local  data  files  or  database.  None 

4.5.13.3.2.11  Limitations.  Norxe 


4.5.13.4  CSU  MsgReadReuseNIncCB. 

The  MsgsReuseNIncCB  CSU  handles  the  callback  for  the  Reuse  and  Ixudude 
pushbuttoa  It  saves  the  currently  displayed  PDU  in  a  global  and  then  brings 
up  the  report  screen  so  that  a  new  rep>ort  can  be  generated  for  inclusion  wi^ 
the  reused  message. 

4.5.13.4.1  CSU  MsgReadReuseNIncCB  requirements. 

The  MsgReadReuseNIncCB  CSU  satisfies  section  3.2.1.2.2.3.1.2  and 
3.2.1.2.2.3.2.3  of  the  specific  reqtiirments  of  the  DMCC  S3rstem. 

4.5.13.4.2  CSU  MsgReadReuseNIncCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgReadReuseNIncCB  CSU. 

4.5.13.4.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contams  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.13.4.2.2  Local  data  elements. 

"pos"  -  position  in  list  highlighted 
"coimt"  -  number  of  items  highlighted 

4.5.13.4.2.3  Interrupts  and  signals.  None 

4.5.13.4.2.4  Algorithms.  None 

4.5.13.42.5  Error  handfing.  None 

4.5.13.42.6  Data  conversion.  None 
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4.5.13.4.2.7  Use  of  othpr  elements.  Other  elements  that  are  used  by 
the  MsgReadReuseNIncCB  CSU: 

"msgReadTmi"  -  widget  id  of  TMI  area  of  msgRead  form 
"msgReadForm"  -  widget  id  of  entry  area  of  msgRead  form 
"msglList"  -  widget  id  of  msgl  list 
"reusePDU"  -  pdu  to  be  forwarded 
"reuseFlag"  -  is  this  a  forwarded  message 

"msglistlndex"  •  array  of  mappings  of  msgl  list  entries  to  messages 
entries 

4.5.13.4.2.8  Logic  flow.  Single  pass. 

4.5.13.4.2.9  Data  structures.  None 

4.5.13.4.2.10  Local  data  files  or  database.  None 

4.5.13.4.2.11  Limitations.  None 


4.5.13.5  CSU  MsgReadReuseCB 

The  MsgsReuseCB  CSU  h.^ndles  the  callback  for  the  Reuse  pushbutton.  It 
saves  the  currently  displayed  PDU  in  a  global  and  thing  brings  up  the  reuse 
report  screen. 

4.5.13.5.1  CSU  MsgReadReuseCB  requirements. 

The  MsgReadReuseCB  CSU  satisfies  section  3.2.1.2.2.3.1.2  and  3.2.1.2.2.3.2.2  of 
the  specific  requirments  of  the  DMCC  system. 

4.5.13.5.2  CSU  MsgReadReuseCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgReadReuseCB  CSU. 

4.5.13.5.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.13.5.2.2  Local  data  elements. 

"pos"  -  position  in  list  highlighted 
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"count"  -  number  of  items  highlighted 
4.5.13.52.3  Interrupts  and  signals.  None 

4.5.13.5.2.4  Algorithms-  None 

4.5.13.5.2.5  Error  handling.  None 
4.5.13.52.6  Data  conversion.  None 

4.5.13.5.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgReadReuseCB  CSU: 

"msgReadTmi"  •  widget  id  of  TMI  area  of  msgRead  form 
"msgReadForm"  *  widget  id  of  entry  area  of  msgRead  form 
"msglList"  -  widget  id  of  msgl  list 
"reusePDU"  -  pdu  to  be  forwanled 
"reuseFlag"  -  is  this  a  forwarded  message 

"msglistlndex"  -  array  of  mappings  of  msgl  list  entries  to  messages 
entries 

4.5.13.5.2.8  Logic  flow.  Single  pass. 

4.5.13.5.2.9  Data  structures.  None 

4.5.13.5.2.10  Local  data  files  or  database.  None 
4.5.13.52.11  Limitarions.  None 

4^.13.6  CSU  MsgReplyCB 

The  MsgsReplyCB  callback  handles  the  callback  fm  the  Reply  pushbutton.  It 
stores  the  CEOI  of  the  sender  of  the  displayed  message  and  then  brings  up  die 
report  screen  for  a  message  to  be  generated  to  the  sender  of  said  message. 

4.5.13.6.1  CSU  MsgReplyCB  requirements. 

The  MsgReplyCB  CSU  satisfies  section  3.2.1.2.2.3.1.2  of  the  specific 
requirments  of  the  DMCC  system. 

4.5.13.62  CSU  MsgReplyCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MsgReplyCB  CSU. 
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4.5.13.6Ji.l  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contaiiu  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.13.6.2.2  Local  data  elements. 

"pos"  -  position  in  list  highlighted 
"cotmt"  -  ntunber  of  items  highlighted 

4.5.13.6.2.3  Interrupts  and  signals.  None 

4.5.13.6.2.4  Algorithms.  None 

4.5.13.6.2.5  Error  handling.  N(me 

4.5.13.6.2.6  Data-CQnVfirsiQn.  None 

4.5.13.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MsgReplyCB  CSU: 

"msgReadTmi"  >  widget  id  of  TMI  area  of  msgRead  form 
"msgReadPorm"  •  widget  id  of  entry  area  of  msgRead  form 
"msgllist"  -  widget  id  of  msgl  list 
"replyFlag"  >  is  this  a  reply 
"replyCEOr  -  reply  return  address 

4.5.13.6.2.8  Logic  flow.  Single  pass. 

4.5.13.62.9  Data  structures.  None 

4.5.13.62.10  Local  data  files  or  database.  None 

4.5.13.62.11  Limitations.  N<me 


4.5.14  Sub-Level  CSC  mtoTmLcall. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
mtoTmi.call  Sub-L^el  CSC  in  terms  of  data  flow  between  the  CSU’s  of  this 
Sub-level  CSC. 
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4.5.14.1  CSU  MtoQearNRetCB 

The  MtoClearNRetCB  CSU  handles  the  callback  from  the  Clear  and  Return 
pushbutton.  It  will  clear  and  unmaiuige  the  Mto  window  and  remanage  the 
Reports  window. 

4.5.14.1.1  CSU  MtoOearNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.5.14.1.2  CSU  MtoQearNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MtoClearNRetCB  CSU. 


4.5.14.1.2.1 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contaiixs  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  None 


4.5.14.1.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 


4.5.14.1.2.3 


s.  None 


4.5.14.1.2.4  Algorithms.  None 


4.5.14.1.2.5 


None 


4.5.14.1.2.6 


iion.  None 


4.5.14.1.2.7  Use  of  other  element 
the  MtoClearNRetCB  CSU: 


Other  elements  that  are  used  by 


"MtoTmiForm"  -  form  widget  contaiiting  Mto  TMI 
'^toForm"  •  form  widget  containing  Mto  Entry  area 
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"cikLabel2"  -  label  widget 

4.5.14.12.8  Logic  flow.  Single  pass 

4.5.14.12.9  Data  structures.  None 

4.5.14.12.10  Local  data  files  or  databaae.  None 
4.5.14.1.2.11  Limitations.  N<me 


4.5.142  CSU  MtoSaveNRetCB 

The  MtoSaveNRetCB  CSU  handles  the  callback  from  the  Save  and  Return 
pushbutton.  It  will  unmanage  the  Mto  window  and  remanage  the  Repmrts 
window. 

4.5.142.1  CSU  MtoSaveNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine*interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.1422  CSU  MtoSaveNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MtoSaveNRetCB  CSU. 

4.5.142.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  oi  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 
4.5.14.222  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nuUChar"  null  character 
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4.5.14.2^.3 


s.  None 


4.5.14.2^.4  Algorithms.  None 
4.5.14.2.2.5  Error  handling.  None 


4.5.14.2.2.6 


1.  None 


4.5.14.2.2.7  Use  of  other  glgmcnts.  Other  elements  that  are  used  by 
the  MtoSaveNRetCB  C^U: 

"MtoTmiForm"  •  form  widget  containing  Mto  TMI 
"MtoForm"  -  form  widget  contaiiting  Mto  Entry  area 
"cikLabel2"  •  label  widget 
"dkLabell"  -  label  widget 

4.5.14.2.2.8  Logic  flow.  Single  pass 


4.5.14.2.2.9 


s.  None 


4.5.14.2.2.10 


^  None 


4.5.14.2.2.11  Limitations.  None 


4.5.14J  eSU  MtoSndRoutCB 

The  MtoSndRoutCB  CSU  handles  the  callback  from  the  Send  Routine 
pushbutton.  It  calls  MtoSend  with  priority  ROUTINE. 

4^.14J.l  CSU  MtoSndRoutCB  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>inte^ace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.143J1  CSU  MtoSndRoutCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MtoSndRoutCB  CSU. 


4.5.14.3.2.1 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 
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"call"  contains  X  Windows  data  about  the  call  reascm 
OUTPUTS:  None 


4.5.143^.2  Local  data  elements.  None 

4.5.14.33.3  Interrupts  and  signals.  None 

4.5.14.3  2.4  Algorithms.  N<me 
4.5.14  33.5  Error  handling.  None 
4.5.14.33.6  Data  conversion.  None 


4.5.14.3.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MtoSndRoutCB  CSU: 

'TRIORrTY.ROUTINE"  •  define  for  priority  message 

4.5.14.3.2.8  Logic  flow.  Single  pass 

4.5.14.33.9  Data  structures.  None 

4.5.14.33.10  Local  data  files  or  database.  None 


4.5.14.33.11  Limitatjons.  None 


4.5.14.4  CSU  MtoSend 

The  MtoSend  CSU  sends  a  message  with  a  given  priority.  It  retrieves  the  data 
from  the  text  entry  area  and  the  annotation  area  and  retrieves  the  address 
from  dte  address  selection  menu.  It  then  sends  the  data  to  bldMto  to  be  sent 
out  It  also  handles  the  case  that  the  message  is  a  reply  by  fixing  the  address  to 
that  from  the  message  being  replied  to.  If  the  message  is  a  Reuse  and  Include, 
the  included  message  will  also  be  sent  to  the  address  selected. 

43.14.4.1  CSU  MtoSend  leqniiements. 

The  MtoSend  CSU  satisfies  section  33.1.2.23.1, 3.2.1.2.2.3.6.1  and  3.2.1.2.23.6.1 
of  the  specific  requirments  of  the  DMCC  system. 

43.14.43  CSU  MtoSend  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MtoSend  CSU. 
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4.5.14.4^1  Input /output  data  elements. 
INPUTS: 

"prio"  •  pricvity  of  the  message  being  sent 
OUTPUTS:  None 


4.5.14.4.2.2  Local  data  elgmente. 

"targetCEOr  •  name  of  user  message  is  being  sent  to 
"annotation''  -  text  (rf  anitotation  string 
"MissionStatus"  -  boolean;  is  this  a  Mission  Status  message 
"RequestAdjustment"  •  boolean;  is  dus  a  Request  Adjustment  message 
"EnterTarget"  -  boolean;  is  this  a  Enter  Target  message 
"EndMission"  •  bocdean;  is  this  a  End  Mission  message 

4.5.14.4.2.3  Interrupts  and  signals.  None 

4.5.14.4.2.4  Algorithms.  Ncme 

4.5.14.4.2.5  Error  handling.  None 

4.5.14.4.2.6  Data  conversion.  None 


4.5.14.4.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MtoSend  CSU: 

"MtoAdd"  •  infonnaticm  on  the  Mto  address  selection  menu 
"reply  flag"  >  boolean;  is  dds  a  reply 
"repl)^CEOI"  -  target  name  for  reply  call 
"reuseFlag"  -  boolean;  is  dus  a  reuse  and  include 


4.5.14.4.2.8  Logic  flow.  Single  pass 
4.5.14.4J2.9  Data  structures.  None 


4.5.14.4.2.10  Local  data  files  or  database.  None 

4.5.14.4.2.11  Limitations.  None 


4.5.14.5  CSUMtoSndUigCB 

The  MtoSndUrgCB  CSU  handles  the  callback  from  the  Send  Urgent 
pushbutton.  It  calls  MtoSend  with  priority  URGENT. 
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4.5.14.5.1  CSU  MtoSndUrgCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-inte^ace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.14.5.2  CSU  MtoSndUfgCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
MtoSndUrgCB  CSU. 

4.5.14.5.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.14.5.2.2  Local  data  elements.  None 

4.5.14.5.2.3  Interrupts  and  signals.  None 

4.5.14.5.2.4  Algorithms.  None 

4.5.14.5.2.5  Error  handling.  None 

4.5.14.5.2.6  Data  conversion.  None 

4.5.14.5.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  MtoSndUrgCB  CSU: 

"PRIORnX.URGENT"  -  define  for  urgent  priority 

4.5.14.5.2.8  Logic  flow.  Single  pass 

4.5.14.5.2.9  Data  structures.  None 

4.5.14.5.2.10  Local  data  files  or  database.  None 

4.5.14.5.2.11  Limitations.  None 
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4.5.14.6  eSU  QearMto 

The  ClearMto  CSU  clears  all  the  entries  of  the  Mto  report  generation  screert 

4.5.14.6.1  CSU  QearMto  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  missimi  equipment  package. 

4.5.14.6.2  CSU  QearMto  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ClearMto  CSU. 

4.5.14.6.2.1  Input /output  data  elements. 

INPUTS: 

OUTPUTS:  None 

4.5.14.6.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nuUChar"  nuU  char 


4.5.14.6.2.3  Interrupts  and  signals.  None 

4.5.14.6.2.4  Algorithms.  None 

4.5.14.6.2.5  Error  handling.  None 

4.5.14.6.2.6  Data  conversion.  None 


4.5.14.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ClearMto  CSU: 

"MtoAdd"  -  info  on  the  selection  menu  for  the  address 
"EnemyType"  •  info  on  the  selection  menu  for  the  enemy  type 
"Enemy Activity"  •  info  on  the  selection  menu  for  the  enemy 
activity 

"Direc"  -  info  on  the  selection  menu  for  the  direction 
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"Obslnt"  -  info  on  the  selection  menu  for  the  observer 
intentions 

^%>eedT»f'  •  widget  id  for  speed  text 
'^umTexf*  •  widget  id  for  number  tnct 
'UnitText^  -  widget  id  for  unit  text 
"cikTextl”'  widget  id  fxx  dkl  text 
"cikText2''-  widget  id  for  cik2  text 

4.5.14.6^.8  Lope  flow.  Single  pass 

4.5.14.6.2.9  Data  structures.  None 

4.5.14.6.2.10  Local  data  files  or  database.  None 

4.5.14.6.2.11  Limitations.  None 


45.15  Sub-Level  CSC  mto.caU. 

The  following  paragraphs  imder  dus  section  describe  the  relationship  of  the 
mto.call  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSlTs  of  this  Sub- 
level  CSC. 

45.15.1  eSU  mtoad.moreCB 

The  mtoad_inoreCB  CSU  handles  the  callback  for  the  mtoad  More 
pushbuttoa  It  displays  additional  selectins  if  they  exist 

45.15.1.1  CSU  mtoad.moreCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digibd  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subhmetion  of  a  helicopter  mission  eqmpment  package. 

45.15.15  CSU  mtoad_moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
mtoad_moreCB  CSU. 

4.5.15.15.1  Input/output  data  elements. 

INPUTS: 

**yt"  contains  widget  id  of  button  pressed 

''client^  contams  client  data 

"call''  contains  X  Windows  data  about  the  call  reas<m 
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OUTPUTS:  . 

4.5.15.1^.2  T^al  data  elements.  None 

4.5.15.1.2.3  Interrupts  and  signals.  None 

4.5.15.1.2.4  Algorithms.  None 

4.5.15.1.2.5  Error  handUng.  None 

4.5.15.1.2.6  Data  conversion.  None 

4.5.15.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  mtoad.moreCB  CSU: 

"MtoAdd"  -  info  on  the  Mto  address  selection  menu 

4.5.15.1.2.8  Logic  flow.  Single  pass 

4.5.15.1.2.9  Data  structures.  None 

4.5.15.1.2.10  Local  data  files  or  database.  None 

4.5.15.1.2.11  Limitations.  None 


4.5.15.2  CSU  mtoad_rotateCB 

The  mtoad^rotateCB  CSU  handles  the  callback  for  the  mtoad  Rotate 
pushbutton.  It  changes  the  currently  selected  entry  to  die  next  entry  (die  first 
entry  if  it  is  at  the  already). 

4.5.15.2.1  CSU  mtoad.rotateCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man'machine'interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.15.2.2  CSU  mtoad_roteteCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
mtoad_rotateCB  CSU. 
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4.5.15.2^.!  Input/output  data  elemanta. 


INPUTS: 

"vt"  omtains  widget  id  oi  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  . 

4.5.15.2^.2  Local  data  elements.  None 
4.5.15.2^3  Interrupts  and  signals.  None 
4.5.15.23.4  Algorithms.  Ncme 

4.5.15.2.2.5  Error  handling.  None 

4.5.15.2.2.6  Data  conversion.  None 

4.5.15.23.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  mtoad_rotateCB  CSU: 

"MtoAdd"  -  info  on  Mto  address  selection  menu 


4.5.15.23.8  Logic  flow.  Single  pass 

4.5.15.23.9  Data  structures.  None 

4.5.15.23.10  Local  data  files  or  database.  None 

4.5.15.23.11  Limitations.  None 


43.153  CSU  PutttpMto 

The  PutupMto  CSU  will  create  the  Mto  report  screen  if  necessary  and  will  also 
manage  ^  screen. 

43.153.1  CSU  PutupMto  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4.5.15J^  CSU  PtttupMto  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
PutupMto  CSU. 

4.5.15.3.2.1  Input/output  data  elements. 

INPUTS:  None 
OUTPUTS:  None 


4.5.15.3.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  ntunber  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"entries"  -  number  of  addresses 


4.5.15.3.2.3  Interrupts  and  signals.  None 

4.5.15.3.2.4  Algorithms.  None 

4.5.15.3.2.5  Error  handling.  None 

4.5.15.3.2.6  Data  conversion.  None 


4.5.15.3.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupMto  CSU: 

'^toForm"  -  widget  id  of  mto  form 
"MtoAdd"  -  info  on  Mto  address  selection  menu 
"addresslist"  -  list  of  addresses 
"MtoMoreLabel"  -  widget  id  of  More  label 
"MtoMoreArrow"  -  widget  id  of  More  arrow 
"replyFlag"  -  boolean;  is  this  a  reply 
"MtoTmiForm"  widget  id  of  mh>  TMI  form 


4.5.15.3.2.8  Logic  flow.  Single  pass 

4.5.153.2.9  Data  structures.  None 


4.5.15.33.10  Local  data  files  or  database.  None 

4.5.15.33.11  Limitations.  N<me 
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4.5.16  Sub-Level  CSC  popupMeasage. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
popupMessage  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of  this 
Sub-level  CSC. 

4.5.16.1  CSU  CreateMessageBox 

The  CreateMessageBox  CSU  creates  a  Popup  message  box  with  a  given 
message  and  a  given  parent. 

4.5.16.1.1  CSU  CreateMessageBox  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  commurucations 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.16.1.2  CSU  CreateMessageBox  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
CreateMessageBox  CSU. 

4.5.16.1.2.1  Input/output  data  elements. 

INPUTS: 

"parent"  -  widget  id  of  parent  object 

"messagestring"  -  string  to  be  displayed  in  the  message  box 

OUTPUTS: 

"retval"  -  widget  id  of  the  message  box 

4.5.16.1.2.2  Local  data  elements. 

"argent"  -  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  -  the  arguments  set  for  XtSetValues 

"argok"  -  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  -  local  to  hold  a  XmString 
"popupMessage"  -  widget  id  of  message  box 

4.5.16.12.3  Interrupts  and  signals.  None 

4.5.16.1.2.4  Algorithms.  None 

4.5.16.12.5  Error  handling.  None 
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4.5.16.1Ji.6  Data  conversion.  None 

4.5.16.12.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  CreateMessageBox  CSU: 

None 

4.5.16.1.2.8  Logic  flow.  Single  pass. 

4.5.16.1.2.9  Data  structures.  None 

4.5.16.1.2.10  Local  data  files  or  database.  None 

4.5.16.1.2.11  Limitations.  None 


4.5.162  ’  createMessage 

•he  createMessage  CSU  unmanages  the  Cancel  and  Help  buttons  of  the 
Message  Box  created  by  CreateMessageBox. 

4.5.162.1  CSU  createMessage  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.1622  CSU  createMessage  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
createMessage  CSU. 

4.5.16.2.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.16.2.2.2  Local  data  elements.  None 
4.5.16.22.3  Interrupts  and  signals.  None 
4.5.16.2.2.4  Algorithms.  None 
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4.5.16.2^.5  Error  handling.  None 
4.5.16.2^.6  Data  conversion.  None 

4.5.16.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  createMessage  CSU: 

None 

4.5.16.2.2.8  Logic  flow.  Single  pass. 

4.5.16.2.2.9  Data  structures.  None 

4.5.16.2.2.10  Local  data  files  or  databasg.  None 

4.5.16.2.2.11  Limitations.  None 


4.5.163  CSU  okbutton 

The  okbutton  CSU  handles  the  callback  for  the  OK  button.  It  destroys  the 
Message  Box. 

4.5.163.1  CSU  okbutton  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  missicm  equipment  package. 

4.5.1633  CSU  okbutton  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
okbutton  CSU. 

4.5.1633.1  Input/output  data  elements. 

INPUTS; 

"w"  ccmtains  widget  id  of  button  pressed 
"client"  contams  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.16.33.2  Local  data  elements.  None 
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4.5.16.3.2.3  Interrupts  and  signals.  None 

4.5.16.3.2.4  Algorithms.  None 

4.5.16.3.2.5  Error  handling.  None 

4.5.16.3.2.6  Data  conversion.  None 

4.5.16.3.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  okbutton  CSU: 

None 

4.5.16.3.2.8  Logic  flow.  Single  pass. 

4.5.16.3.2.9  Data  structures.  None 

4.5.16.3.2.10  Local  data  files  or  database.  None 

4.5.16.3.2.11  Limitations.  None 


4.5.16.4  CSU  unmanageMessage 

The  unmanageMessage  CSU  handles  the  timer  event  set  for  three  seconds 
and  destorys  the  Message  Box. 

4.5.16.4.1  CSU  unmanageMessage  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.5.16.4.2  CSU  unmanageMessage  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
unmanageMessage  CSU. 

4.5.16.42.1  Input/output  data  elements. 

INPUTS: 

"data"  -  widget  id  of  widget  to  be  destroyed 
"id"  -  calling  data 

OUTPUTS:  None 
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4.5.16.4J1.2  Local  data  elements.  None 

4.5.16.42.3  Interrupts  and  siynaU.  None 

4.5.16.42.4  Algorithms.  None 

4.5.16.42.5  Error  handling.  None 

4.5.16.42.6  Data  conversion.  None 

4.5.16.42.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  unmanageMessage  CSU: 

None 

4.5.16.42.8  Logic  flow.  Sing^  pass. 

4.5.16.42.9  Data  structures.  None 

4.5.16.42.10  Local  data  files  or  database.  None 

4.5.16.42.11  Limitations.  None 


4.5.16J  CSU  popupTransientMessage 

The  ^pupTransientMessage  CSU  creates  a  Message  Box  which  can  either  be 
dismissed  or  will  destroy  itself  after  5  seconds. 


4.5.16,5.1  CSU  popupTransientMessage  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine*interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.16.52  CSU  popupTransientMessage  design. 


The  information  identified  below  represents  the  detailed  design  of  the 
popupTransientMessage  CSU. 


4.5.16.52.1 


Input/output  data  el 


INPUTS: 

"parent"  •  widget  id  of  parent  object 

"messagestring"  >  string  to  be  displayed  in  the  message  box 
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OUTPUTS:  None 

4.5.16.5.2.2  Local  data  elements. 

"argent"  -  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  -  the  arguments  set  for  XtSetValues 

"argok"  -  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  •  local  to  hold  a  XmString 

4.5.16.5.2.3  Interrupts  and  signals.  None 

4.5.16.5.2.4  Algorithms.  None 

4.5.16.5.2.5  Error  handling.  None 

4.5.16.5.2.6  Data  conversion.  None 

4.5.16.5.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  popupTransientMessage  CSU: 

None 

4.5.16.5.2.8  Logic  flow.  Single  pass. 

4.5.16.5.2.9  Data  structures.  None 
4.5.16.52.10  Local  data  files  or  database.  None 
4.5.16.5.2.11  Limitations.  None 


4.5.16.6  CSU  popupMessageBox 

The  popupMessageBox  CSU  creates  a  Message  Box  which  can  be  dismissed. 
4.5.16.6.1  CSU  popupMessageBox  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmetion  of  a  helicopter  mission  equipment  package. 

4.5.16.62  CSU  popupMessageBox  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
{)opupMessageBox  CSU. 
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4.5.16.6^.!  Input/output  data  elements. 

INPUTS: 

"parent*  •  widget  id  of  parent  object 

"messageString"  -  string  to  be  displayed  in  the  message  box 

OUTPUTS:  None 

4.5.i6.6^.2  Local  data  etements. 

"argent"  -  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  *  the  argiiments  set  for  XtSetValues 

"argok"  >  a  boolean  which  is  used  to  check  die  success  of  the  CONVERT 
call 

"xmstr"  -  local  to  hold  a  XmString 


4.5.16.62.3  Interrupts  and  signals.  None 

4.5.16.62.4  Algorithms.  None 

4.5.16.62.5  Error  handling.  None 
4.5.16.6.2.6  Data  conversion.  None 

4.5.16.62.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  popupMessageBox  CSU: 

None 

4.5.16.62.8  Logic  flow.  Single  pass. 

4.5.16.6.2.9  Data  structures.  None 

4.5.16.6.2.10  Local  data  files  or  database.  None 
4.5.16.62.11  Limitations.  Noiw 


4^17  Sub-Level  CSC  reportCB. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
reportCB  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU*s  of  this  Sub- 
level  CSC. 
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4.5.17.1  CSU  ReportMtoCB 

The  ReportMtoCB  CSU  is  the  callback  that  brings  up  ^  MTO  report  screen 
for  report  entry. 

4.5.17.1.1  CSU  ReportMtoCB  requirements. 

The  ReportMtoCB  CSU  satisfies  section  3.2.1.2.2.3.2.2  of  the  specific 
requirments  of  the  DMCC  system. 

4.5.17.1.2  CSU  ReportMtoCB  design. 

The  iitformation  identified  below  represents  the  detailed  design  of  the 
ReportMtoCB  CSU. 

4.5.17.1.2.1  Input /output  data  elements. 

INPUTS; 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.17.12.2  Local  data  elements.  None 
4.5.17.1.2.3  Interrupts  and  signals.  None 

4.5.17.12.4  Algorithms.  None 

4.5.17.12.5  Error  handling.  None 
4.5.17.1.2.6  Data  conversion.  None 

4.5.17.12.7  Usg  of  other  elements.  Other  elements  that  are  used  by 
the  Re|x>rtMtoCB  CSU: 

"reportTmi"  -  widgit  id  for  the  report  window  TMI  area 
"reportForm"  -  widgit  id  for  the  report  window  entry  area 

4.5.17.12.8  Logic  flow.  Single  pass. 

4.5.17.12.9  Data  structures.  None 
4.5.17.1.2.10  Local  data  files  or  database.  None 
4.5.17.12.11  Limitations.  Norw 
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4.5.17^  CSU  ReportSplashCB 

The  RepcfftSplashCB  CSU  is  the  callback  that  brings  up  the  Splash  repmt 
screen  for  report  entry. 

4.5.17^1  CSU  ReportSplashCB  requirements. 

The  ReportSplashCB  CSU  satisfies  section  3.2.1.2.2.3.2.2  of  the  sp>ecific 
requirments  of  the  DMCC  system. 

4.5.17.2.2  CSU  ReportSplashCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReportSplashCB  CSU. 

4.5.17.2.2.1  Input/Qutput  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.17.2.2.2  Local  data  filfiments-  None 

4.5.17.2.2.3  Interrupts  and  signals.  None 

4.5.17.2.2.4  Algorithms.  None 

4.5.17.2.2.5  Error  handling.  None 

4.5.17.2.2.6  Data  conversion.  None 

4.5.17.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReportSplashCB  CSU: 

"reportTmi"  -  widgit  id  for  the  report  window  TMI  area 
"reportPorm"  •  widgit  id  for  the  report  window  entry  area 

4.5.17.2.2.8  Logic  flow.  Single  pass. 

4.5.17.2.2.9  Data  structures.  None 

4.5.17.2.2.10  Local  data  files  or  database.  None 

4.5.17.2.2.11  Limitations.  None 
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4J.173  CSU  RcpoitRcqlCB 

The  ReportReqtCB  CSU  is  the  callback  that  brings  up  the  Request  report 
screen  for  report  entry. 

45.17 J.1  CSU  ReportReqtCB  requirements. 

The  ReportReqtCB  CSU  satisfies  section  3.2.1.2.2.3.2.2  of  the  specific 
requirments  of  ^e  DMCC  system. 

45.1755  CSU  ReportReqtCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReportReqtCB  CSU. 

4.5.17.3.2.1  Input/Qutput  data  elements. 

INPUTS: 

"w"  contains  widget  id  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  None 

4.5.17.35.2  Local  data  filemmts.  None 

4.5.17.3.2.3  Interrupts  and  signals.  None 

4.5.17.3.2.4  Algorithms.  None 

4.5.17.35.5  Error  handling.  None 

4.5.17.35.6  Data  conversion.  None 

4.5.17.35.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReportReqtCB  CSU: 

"reportTmi"  -  widgit  id  for  the  report  window  TNJ  area 
"reportForm"  >  widgit  id  for  the  report  window  entry  area 

4.5.17.35.8  Logic  flow.  Single  pass. 

4.5.17.35.9  Data  structures.  None 

4.5.17.35.10  Local  data  files  or  database.  None 

4.5.17.35.11  Limitations.  None 
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4.5.17.4  CSU  RcportMovcmdCB 

The  ReportMovcmdCB  CSU  is  the  callback  that  brings  up  the  Movcmd  report 
screen  for  repcnrt  entry. 

4.5.17.4.1  CSU  RepoftMovcmdCB  requiftments. 

The  ReportMovcmdCB  CSU  satisfies  section  3.2.1.2.2.3.2.2  of  the  specific 
requirments  of  the  DMCC  system. 

4.5.17.4.2  CSU  ReportMovcmdCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReportMovcmdCB  CSU. 

4.5.17.4.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.17.4.2.2  Local  data  elements.  None 


4.5.17.4.2.3  Ii 


and  signals.  None 


4.5.17.42.4  Algorithms.  Ncme 


4.5.17.42.5  Error  handUng.  None 

4.5.17.4.2.6  Data  conversiorL  None 

4.5.17.4.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReportMovcmdCB  CSU: 

"reportTmi"  -  widgit  id  for  die  report  window  TMI  area 
"reportForm"  •  widgit  id  for  the  repcnrt  window  entry  area 

4.5.17.42.8  Logic  flow.  Single  pass. 

4.5.17.42.9  Data  structures.  None 


4.5.17.4.2.10  Local  data  files  or  database.  None 


4.5.17.42.11  Limitations.  None 
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4.5.17.5  CSU  RepoitShotCB 

The  ReportShotCB  CSU  is  the  callback  brin^  up  the  Shot  report  screen 
for  report  entry. 

43.17.5.1  CSU  ReportShotCB  requirements. 

The  ReportShotCB  CSU  satisfies  section  3.2.1.2.2.3.2.2  of  the  specific 
requirments  of  the  DMCC  system. 

4.5.17.5.2  CSU  ReportShotCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReportShotCB  CSU. 

4.5.17.5.2.1  Input /output  data  elcmgnts. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.17.5.2.2  Local  data  elements.  None 

4.5.17.5.2.3  Interrupts  and  signals.  None 

4.5.17.5.2.4  Algorithms.  None 

4.5.17.5.2.5  Error  handling.  None 

4.5.17.5.2.6  Data  conversion.  None 

4.5.17.5.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReportShotCB  CSU: 

"reportTmi"  -  widgit  id  for  die  report  window  TMI  area 
"reportForm"  -  widgit  id  for  the  report  window  entry  area 

4.5.17.5.2.8  Logic  flow.  Single  pass. 

4.5.17.5.2.9  Data  structures.  None 

4.5.17.5.2.10  Local  data  files  or  database.  None 

4.5.17.5.2.11  Limitations.  None 
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4.5.17.6  CSU  ReportSpotCB 

The  ReportSpotCB  CSU  is  the  callback  that  brings  up  the  %x>t  report  screen 
for  report  entry. 

4.5.17.6.1  CSU  ReportSpotCB  reqairements. 

The  ReportSpotCB  CSU  satisfies  section  3.2.1.2.2.3.2.2  of  the  specific 
requirments  of  the  DMCC  system. 

4.5.17.6.2  CSU  ReportSpotCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReportSpotCB  CSU. 

4.5.17.6.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.17.6.2.2  Local  data  elements.  None 
4.5.17.6J:.3  Interrupts  and  signals.  None 

4.5.17.6.2.4  Algorithms.  None 

4.5.17.6.2.5  Error  handling.  None 

4.5.17.6.2.6  Data  conversion.  None 

4.5.17.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReportSpotCB  CSU: 

"reportTmi"  •  widgit  id  for  the  report  window  TMI  area 
"repenrtForm"  -  widgit  id  for  the  report  window  entry  area 

4.5.17.6.2.8  Logic  flow.  Single  pass. 

4.5.17.6.2.9  Data  structures.  None 

4.5.17.6.2.10  Local  data  files  or  database.  None 

4.5.17.6.2.11  Umitations.  None 
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4.5.17.7  CSU  ReportFrecTxtCB 

The  ReportFreeTxtCB  CSU  is  the  callback  that  brings  up  the  Free  Text  report 
saeen  for  report  entry. 

4.5.17.7.1  CSU  ReportFreeTxtCB  requirements. 

The  ReportFreeTxtCB  CSU  satisfies  section  3.2.1.2.2.3.2.2  of  the  specific 
requirments  of  the  DMCC  system. 

4.5.17.7.2  CSU  ReportFreeTxtCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReportFreeTxtCB  CSU. 

4.5.17.7.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS;  None 

4.5.17.7.2.2  Local  data  elements.  None 

4.5.17.7.2.3  Interrupts  and  signals.  None 
4.5.17.7J.4  Algorithms.  None 

4.5.17.7.2.5  Error  handling.  None 

4.5.17.7.2.6  Data  conversion.  None 

4.5.17.7.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReportFreeTxtCB  CSU: 

"rep>ortTmi"  >  widgit  id  for  the  repOTt  window  TMl  area 
"reportForm"  -  widgit  id  for  the  report  window  entry  area 

4.5.17.7.2.8  Logic  flow.  Single  pass. 

4.5.17.7.2.9  Data  structures.  None 

4.5.17.7.2.10  Local  data  files  or  database.  None 
4.5.17.72.11  Limitations.  None 


Page  216 


Dociunerit  ADST/WDL/TR-93-003036 


March  31, 1993 


4.5.17J  CSU  ReportSaveExitCB 

4.5.17.8.1  CSU  ReportSaveExitCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.17.8.2  CSU  ReportSaveExitCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReportSaveExitCB  CSU. 

4.5.17.8.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.17,8.2.2 

Local  data  elements.  None 

4.5.17.8.2.3 

Interrupts  and  signals.  None 

4.5.17.8.2.4 

Algorithms.  None 

4.5.17.8.2.5 

Error  handUng.  None 

4.5.17.8.2.6 

Data  conversion.  None 

4.5.17.8.2.7  Use  of  other  elements.  Other  elements  that  are  used  bv 
the  ReportSaveExitCB  CSU: 

"reportTmi"  -  widgit  id  for  the  report  window  TMI  area 
"reporiForm"  -  widgit  id  for  the  report  window  entry  area 
"replyFlag"  >  is  this  a  reply 
"reuseFlag"  >  is  this  a  forwarded  message 

4.5.17.8.2.8 

Logic  flow.  Single  pass. 

4.5.17.8.2.9 

Data  structures.  None 

4.5.17.82.10 

Local  data  files  or  database.  None 
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4.5.17.8.2.11  Limitations.  None 


4.5.17.9  CSU  ReportMsgsCB 


4.5.17.9.1  CSU  ReportMsgsCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-inte^ace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.17.9.2  CSU  ReportMsgsCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReportMsgsCB  CSU. 

4.5.17.9.2.1  Input/output  data  elements. 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.17.9.2.2  Local  data  filemeals-  None 

4.5.17.9.2.3  Interrupts  and  signals.  None 

4.5.17.9.2.4  Algorithms.  None 

4.5.17.9.2.5  Error  handling.  None 

4.5.17.9.2.6  Data  conversion.  None 


4.5.17.9.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReportMsgsCB  CSU: 

"reportTmi"  -  widgit  id  for  the  report  window  TMI  area 
"reportForm"  >  widgit  id  for  the  report  window  entry  area 
"replyFlag"  -  is  this  a  reply 
"reuseFlag"  -  is  this  a  forwarded  message 


4.5.17.9.2.8  Logic  floiY.  Single  pass. 
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4.5.17.9^.9  Data  stnichirg^.  None 
4.5.17.9^.10  Local  data  fil^a  nr  databaag.  None 
4.5.17.9.2.11  Umitarions.  None 


4.5.17.10  CSU  PutupReport 

The  PutupReport  CSU  is  the  callback  tiuit  brings  up  the  MTO  report  screen  for 
report  entry. 

4.5.17.10.1  CSU  PutupReport  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digitad  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.17.10.2  CSU  PutupReport  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
PutupReport  CSU. 


4.5.17.10.2.1  Input/oRtput  data  etomts. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.17.10.2.2  Local  data  elements.  None 

4.5.17.10.2.3  Interrupts  and  signals.  None 
4.5.17.10J1.4  Algorithms.  None 

4.5.17.10.2.5  Error  handling.  None 

4.5.17.10.2.6  Data  conversion.  None 

4.5.17.10.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupReport  CSU: 
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"reportTmi"  -  widgit  id  for  the  report  window  TMI  area 
"reportForm"  -  widgit  id  for  the  report  window  entry  area 
"tmiScreen"  -  widget  id  of  current  TMI 
"smdScreen"  -  widget  id  of  current  enteiry  screen 

4.5.17.10.2.8  Logic  flow.  Single  pass. 

4.5.17.10.2.9  Data  structures.  None 

4.5.17.10.2.10  Local  data  files  or  database.  None 

4.5.17.10.2.11  Limitations.  None 


4.5.18  Sub'LevelCSC  reqtTmi.call. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
reqtTmi_call  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSLTs  of  this 
Sub-level  CSC. 

4.5.18.1  CSU  ReqtQearNRetCB 

The  ReqtClearNRetCB  CSU  handles  the  callback  from  the  Clear  and  Return 
pushbutton.  It  will  clear  and  unmanage  the  Reqt  window  and  remanage  the 
Reports  window. 

4.5.18.1.1  CSU  ReqtClearNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.18.1J!  CSU  ReqtQearNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReqtQearNRetCB  CSU. 

4.5.18.12.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 
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4.5.18.1^.2  Local  data  dements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 

4.5.18.1.2.3  Interrupts  and  signals.  None 

4.5.18.1.2.4  Algorithms.  None 

4.5.18.1.2.5  Error  handUny.  None 

4.5.18.1.2.6  Data  conversion.  None 

4.5.18.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReqtClearNRetCB  CSU: 

"ReqtTmiForm"  -  form  widget  containing  Reqt  TMI 
"ReqtForm"  -  form  widget  containing  Reqt  Entry  area 
"cikLabel2"  >  label  widget 

4.5.18.1.2.8  Logic  flow.  Single  pass 

4.5.18.1.2.9  Data  structures.  None 
4.5.18.12.10  Local  data  files  or  database.  None 
4.5.18.1.2.11  Limitarions.  None 


4,5.182  CSU  ReqtSaveNRetCB 

The  ReqtSaveNRetCB  CSU  handles  tlw  callback  from  the  Save  and  Return 
pushbutton.  It  will  unmanage  the  Reqt  window  and  remanage  tl^  Rep>orts 
window. 

4.5.182.1  CSU  ReqtSaveNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machii\e>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4.5.18JL2  CSU  ReqtSaveNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReqtSaveNRetCB  CSU. 

4.5.18.2.2.1  Input /output  data  plements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.18.2.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  argiunents  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nullChar"  null  character 


4.5.18.22.3 


s.  None 


4.5.18.22.4  Algorithms.  None 


4.5.18.22.5 


line.  None 


4.5.18.22.6 


1.  None 


4.5.18.22.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReqtSaveNRetCB  CSU: 

"ReqtTmiForm"  -  form  widget  containing  Reqt  TMI 
"ReqtForm"  -  form  widget  containing  Reqt  Entry  area 
"cikLabel2"  -  label  widget 
"dkLabell"  -  label  widget 

4.5.18.2.2.8  Logic  flow.  Single  pass 


4.5.18.22.9 


5.  None 


4.5.18.22.10 


None 


4.5.18.22.11  Limitations.  None 
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43.183  CSU  ReqtSndRoutCB 

The  ReqtSndRoutCB  CSU  handles  the  callback  from  the  Send  Routine 
pushbutton.  It  calls  ReqtSend  with  priority  ROUTINE. 

43.183.1  CSU  ReqtSndRoutCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

43.1833  CSU  ReqtSndRoutCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReqtSndRoutCB  CSU. 

4.5.18.33.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  C3f  button  pressed 
"client"  contams  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.18.33.2  Local  data  elements.  None 

4.5.18.33.3  Interrupts  and  signals.  None 
4.5.1833.4  Algorithms.  N<me 
4.5.18.33.5  Error  handling.  None 

4.5.1833.6  Data  conversion.  None 

4.5.1833.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReqtSndRoutCB  CSU: 

"PRIORTTY.ROUTINE"  •  defiite  for  priority  message 

4.5.1833.8  Logic  flow.  Single  pass 

4.5.1833.9  Data  structures.  None 

4.5.1833.10  Local  data  files  or  database.  None 
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4.5.183^.11  Limitations.  None 


43.18.4  CSU  ReqtSend 

The  ReqtSend  CSU  sends  a  message  widi  a  given  prumty.  It  retrieves  the  data 
from  the  text  entry  area  and  the  axmotation  area  ami  retrieves  die  address 
from  the  address  selection  menu.  It  then  sends  the  data  to  bldReqt  to  be  sent 
out  It  also  handles  the  case  that  the  message  is  a  reply  by  fixing  tlw  address  to 
that  from  the  message  being  replied  to.  If  the  message  is  a  Reuse  and  Include, 
the  included  message  will  also  be  sent  to  dw  address  selected. 

4.5.18.4.1  CSU  ReqtSend  requirements 

The  ReqtSend  CSU  satisfies  section  33.1.2.23.1, 3.2.1.2.23.6.1  and  33.1333.6.1 
of  the  specific  requirments  of  the  DMCC  system. 

4.5.18.43  CSU  ReqtSend  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReqtSend  CSU. 

4.5.18.43.1  Input/output  data  elements. 

INPUTS: 

"prio"  •  priority  of  the  message  being  sent 
OUTPUTS:  None 


4.5.18.43.2 


Local  data  elei 


"targetCEOI"  •  name  of  user  message  is  being  sent  to 
"aimotation"  -  text  of  annotatitm  string 
"reportType"  •  type  of  report  requested 
"reconType"  -  type  of  reccoi 


4.5.18.433  Interrupts  and  signals.  None 


4.5.18.43.4  Algorithms.  Ncme 

4.5.18.43.5  Error  handling.  None 


4.5.18.43.6  Data  conversion.  None 


4.5.18.43.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReqtSend  CSU: 

"ReqtAdd"  >  information  on  the  Reqt  address  selection  menu 
"reply  flag"  •  boolean;  is  dus  a  reply 
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^replyCEOr  -  target  name  Ux  reply  call 
'Type"  -  information  on  the  Type  selectim  menu 
"R^n"  -  information  on  the  Recon  selection  menu 
"reuaeFlag"  -  boolean;  is  a  re\ise  and  include 

4.5.18.4.2.8  Logic  flow.  Single  pass 

4.5.18.4.2.9  Data  stnichirgs.  None 

4.5.18.4.2.10  Local  data  files  or  database.  None 

4.5.18.4.2.11  Limitations.  Ncme 


4.5.18,5  CSU  ReqtSndUigCB 

The  ReqtSndUrgCB  CSU  handles  the  callback  from  the  Send  Urgent 
pushbutton.  It  calls  ReqtSend  with  priority  URGENT. 

43.183.1  CSU  ReqtSndUigCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  oi  a  helicopter  missitm  equipment  package. 

43.1833  CSU  ReqtSndUigCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReqtSndUrgCB  CSU. 

4.5.18.53.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.18.533  Local  data  elements.  None 
4.5.18.533  Interrupts  and  signals.  None 
4.5.18.5.2.4  Algorithms.  None 
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4.5.18.5^.5  Error  handling.  None 
4.5.18.5Ji.6  Data  conversion.  None 

4.5.18.5^.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReqtSndUrgCB  CSU: 

"PRIORITY_ufcENT''  -  define  for  urgent  priority 

4.5.18.5.2.8  Logic  flow.  Single  pass 

4.5.18.5.2.9  Data  structures.  None 

4.5.18.5.2.10  Local  data  files  or  database.  None 

4.5.18.5.2.11  Limitations.  None 


45.18.6  CSU  QearReqt 

The  ClearReqt  CSU  clears  all  the  entries  of  the  Reqt  report  generation  screen. 

45.185.1  CSU  QearReqt  requirements. 

This  CSU  satisfies  internally  derived  contractor  reqturements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-inte^ace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

45.18.65  CSU  QearReqt  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ClearReqt  CSU. 


4.5.18.65.1  Input/output  data  elements. 
INPUTS: 

OUTPUTS:  None 


4.5.18.65.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmStting 
"nullChar"  null  char 
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4.5.18.6^3  Intemipts  and  signals.  None 

4.5.18.6.2.4  Alforithms.  None 

4.5.18.6.2.5  Error  handling.  None 

4.5.18.6.2.6  Data  conversion.  None 


4.5.18.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ClearReqt  CSU: 

"ReqtAdd"  >  info  on  dte  selecticm  menu  for  die  address 
"EnemyType''  -  info  on  die  selection  menu  for  the  enemy  type 
"'Enemy Activity"*  ~  info  cm  die  selection  menu  for  the  enemy 
activity 

"Direc"  -  info  on  die  selection  menu  for  the  direction 
"Obslnt"*  •  info  on  the  selection  menu  for  the  observer 
intentions 

"^leedText"*  •  widget  id  for  ^>eed  text 
"NumText"  -  widget  id  for  number  text 
"UnitText"  >  widget  id  for  unit  text 
"dkTextl"*  widget  id  for  dkl  text 
"cikText2"-  widget  id  for  cik2  text 


4.5.18.6.2.8  Logic  flow.  Single  pass 


4.5.18.6.2.9  Data  structures.  None 


4.5.18.6.2.10  Local  data  files  or  database.  None 


4.5.18.6.2.11  Limitations.  None 


43.19  Sub-LevdCSC  reqt_call. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
reqt  call  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of  this  Sub¬ 
level  CSC. 

43.19.1  CSU  t]rpe.moieCB 

The  typead.moreCB  CSU  handles  the  callback  for  the  typead  More 
pushbutton.  It  displays  additional  selectins  if  they  exist 
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4.5.19.1.1  CSU  type.moreCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.19.1.2  CSU  type.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
type_moreCB  CSU. 

4.5.19.1.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.19.1.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 

4.5.19.1.2.3  Interrupts  and  signals.  None 

4.5.19.1.2.4  Algorithms.  None 

4.5.19.1.2.5  Error  handling.  None 

4.5.19.1.2.6  Data  conversion.  None 

4.5.19.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  type_moreCB  CSU: 

'Type"  -  info  on  Enemy  Activity  selection  menu 

4.5.19.1.2.8  Logic  flow.  Single  pass 

4.5.19.1.2.9  Data  structures.  None 

4.5.19.1.2.10  Local  data  files  or  database.  None 
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4.5.19.1^11  Umitations.  None 


4.5.19.2  CSU  t3rpe_rotateCB 

The  typead_rotateCB  CSU  handles  the  callback  for  the  typ>ead  Rotate 
pushbutton.  It  changes  the  currently  selected  entry  to  the  next  entry  (die  first 
entry  if  it  is  at  the  end  already). 

4.5.19.2.1  CSU  type.rotateCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man*machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  a  helicopter  mission  equipment  package. 

45.19.2.2  CSU  t]rpe_rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
type_rotateCB  CSU. 

4.5.19.2.2.1  Input/output  data  elements. 

INPUTS: 

''w"  contains  widget  id  ctf  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 


4.5.19.2.2.2 


4.5.19.2.2.3 

4.5.192.2.4 


Local  data  elements.  None 
Interrupts  and  signals.  None 
Algorithms.  None 


4.5.19.22.5  Krmr  handling.  None 

4.5.19.22.6  Data  conversion.  None 

4.5.19.22.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  type_rotateCB  CSU: 

'Type"  >  irfo  on  the  enemy  activity  selection  menu 


4.5.19.22.8  Logic  flow.  Surpass 
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4.5.19.2^.9  Data  stnictureg.  None 
4.5.19.2^.10  Local  data  files  or  database.  None 
4.5.19.2.2.11  Limitations.  None 


4.5.193  CSU  recon.rotateCB 

The  reconad.rotateCB  CSU  handles  the  callback  for  the  reconad  Rotate 
pushbuttoa  It  changes  the  currently  selected  entry  to  die  next  entry  (die  first 
entry  if  it  is  at  die  ei^  already). 

4.5.193.1  CSU  recon.rotateCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.5.1933  CSU  recon.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
recon_rotateCB  CSU. 

4.5.19.3.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  . 

4.5.19.33.2  Local  data  elements.  None 
4.5.1933.3  Interrupts  and  signals.  None 
4.5.19.3.2.4  Algorithms.  Ncme 
4.5.1933.5  Error  handfing.  None 
4.5.19.33.6  Data  conversion.  None 
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4.5.19.3.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  recon.rc»ateCB  CSU: 

"Recon"  -  info  on  the  enemy  activity  selection  menu 

4.5.19.3.2.8  Logic  flow.  Single  pass 

4.5.19.3.2.9  Data  structures.  None 

4.5.19.3.2.10  Local  data  files  or  database.  None 

4.5.19.3.2.11  Limitations.  None 


4.5.19.4  CSU  reqtad.moreCB 

The  reqtad.moreCB  CSU  handles  the  callback  for  the  reqtad  More 
pushbutton.  It  displays  additional  selectins  if  they  exist 

4.5.19.4.1  CSU  rcqtad.morcCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-inte^ace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.19.4.2  CSU  reqtad.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
reqtad_moreCB  CSU. 

4.5.19.4.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 

4.5.19.4.2.2  Local  data  elements.  None 

4.5.19.4.2.3  Interrupts  and  signals.  None 

4.5.19.4.2.4  Algorithms.  None 

4.5.19.4.2.5  Error  handling.  None 
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4.5.19.4.2.6  Data  conversion.  None 

4.5.19.4.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  reqtad_moreCB  CSU: 

"ReqtAdd"  -  info  on  the  Reqt  address  selection  menu 

4.5.19.4.2.8  Logic  flow.  Single  pass 

4.5.19.4.2.9  Data  structures.  None 

4.5.19.4.2.10  Local  data  files  or  database.  None 

4.5.19.4.2.11  Limitations.  None 


4.5.19.5  CSU  reqtad_rotateCB 

The  reqtad_rotateCB  CSU  handles  the  callback  for  the  reqtad  Rotate 
pushbutton.  It  changes  the  currently  selected  entry  to  the  next  entry  (the  first 
entry  if  it  is  at  the  end  already). 

4.5.19.5.1  CSU  reqtad_rotateCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.19.5.2  CSU  reqtad.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
reqtad_rotateCB  CSU. 

4.5.19.5.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 

4.5.19.5.2.2  Local  data  elements.  None 

4.5.19.5.2.3  Interrupts  and  signals.  None 
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4.5.19.5.2.4  Algorithms.  None 

4.5.19.5.2.5  Error  handling.  None 

4.5.19.5.2.6  Data  conversion.  None 

4.5.19.5.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  reqtad.rotateCB  CSU: 

"ReqtAdd"  -  info  on  Reqt  address  selection  menu 

4.5.19.5.2.8  Logic  flow.  Single  pass 

4.5.19.5.2.9  Data  structures.  None 

4.5.19.5.2.10  Local  data  files  or  database.  None 

4.5.19.5.2.11  Limitations.  None 


4.5.19.6  CSU  PutupReqt 

The  PutupReqt  CSU  will  create  the  Reqt  report  screen  if  necessary  and  will 
also  manage  ^e  screea 

4.5.19.6.1  CSU  PutupReqt  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.19.6.2  CSU  PutupReqt  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
PutupReqt  CSU. 

4.5.19.6.2.1  Input/output  data  elements. 

INPUTS:  None 

OUTPUTS:  None 

4.5.19.6.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 
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"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"entries"  -  number  of  addresses 


4.5.19.6.2.3  Interrupts  and  signals.  None 

4.5.19.6.2.4  Algorithms.  Ncme 

4.5.19.6.2.5  Error  handling.  None 

4.5.19.6.2.6  Data  conversion.  None 


4.5.19.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupReqt  CSU: 

"ReqtForm"  -  widget  id  of  reqt  form 
"ReqtAdd"  -  info  on  Reqt  addr^s  selection  menu 
"addressList"  -  list  of  addresses 
"ReqtMoreLabel"  -  widget  id  of  ^fore  label 
"ReqtMoreArrow"  -  widget  id  of  More  arrow 
"replyRag"  -  boolean;  is  this  a  reply 
"ReqtTmiForm"  widget  id  of  req^  TMI  form 


4.5.19.6.2.8  Lope  flow.  Single  pass 
4.5.19.62.9  Data  structures.  None 
4.5.19.6.2.10  Local  data  files  or  database.  None 


4.5.19.62.11  Limitations.  None 


4.520  Sub-Level  CSC  reuseTmi.calL 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
reuseTmi_call  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSLTs  of  this 
Sub-level  CSC. 

4.520.1  CSU  ReuseOearNRetCB 

The  ReuseOearNRetCB  CSU  handles  the  callback  from  the  Clear  and  Return 
pushbutton.  It  will  clear  and  uiunanage  the  Reuse  window  axul  remanage 
the  Reports  window. 
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4.5.20.1.1  CSU  ReuseQearNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.20.1.2  CSU  ReuseQearNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReuseQearNRetCB  CSU. 

4.5.20.1.2.1  Input /output  data  elemente. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.20.1.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  ?  XmString 

4.5.20.1.2.3  Interrupts  and  signals.  None 

4.5.20.1.2.4  Algorithms.  None 

4.5.20.1.2.5  Error  handling.  None 

4.5.20.1.2.6  Data  conversion.  None 

4.5.20.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReuseQearNRetCB  CSU: 

"ReuseTmiForm"  -  form  widget  containing  Reuse  TMI 
"ReuseForm"  -  form  widget  containing  Reuse  Entry  area 
"cikLabel2"  -  label  widget 

4.5.20.1.2.8  Logic  flow.  Single  pass 

4.5.20.1.2.9  Data  structures.  None 
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4.5.20.1.2.10  Local  data  files  or  database.  None 

4.5.20.1.2.11  Limitations.  Nc«ne 

4.5.20.2  CSU  ReuseSendCB 

The  ReuseSendCB  CSU  handles  the  callback  frmn  the  Send  ptishbuttim.  It 
forwards  the  selected  message  to  tiw  selected  address. 

4.5.20.2.1  CSU  ReuseSend  requirements. 

The  ReuseSend  CSU  satisfies  section  3.2.1.2.233.1  ot  the  specific  requirmeats 
of  the  DMCC  system. 

4.53033  CSU  ReuseSend  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ReuseSend  CSU. 

4.5.20.23.1  Input/output  data  elements. 

INPUTS: 

"prio"  -  priority  of  the  message  being  sent 
OUTPUTS:  None 

4.5.20.2.2.2  Local  data  elements. 

"targetCEOI"  -  name  of  user  message  is  being  sent  to 

4.5.20.2.2.3  Interrupts  and  signals.  None 
4.5.20.23.4  Algorithms.  None 

4.530.23.5  Error  handUng.  None 

4.530.23.6  Data  conversion.  None 

4.5.20.23.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ReuseSeiul  CSU: 

"ReuseAdd"  •  information  on  tiie  Reuse  address  selection  menu 
"retisePDU"  -  PDU  to  be  fmrwarded 

4.53033.8  Logic  flow.  Surpass 

4.530.23.9  Data  structures.  None 
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4.5^0.2^.10  Local  data  filgs  or  database.  None 
4.5^0^.11  Limitationa.  None 


4^03  CSU  QearReose 

The  ClearReuse  CSU  dears  all  the  entries  of  the  Reuse  report  geiteraticm 
screen. 

4^^03.1  CSU  QearReuse  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commuitications  System  compliant 
with  customer  directives  to  provide  a  man*machine>interface  (MMI)  aiul 
system  behavior  which  emulate  the  digital  message  commuiucations 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.20  J.2  CSU  QearReuse  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ClearReuse  CSU. 


4.5.20.3.2.1  Input/output  data  elements. 

INPUTS: 

OUTPUTS:  None 

4.5.20.3.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  argiunents  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nullChar"  null  char 

4.5.20.3.23  Interrupts  and  signals.  None 
4.530.33.4  Algorithms.  None 
4.530.3.2.5  Error  handling.  None 
4.53033.6  Data  conversion.  None 
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4.5.20.3^.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ClearReuse  CSU: 

"ReuseAdd"  -  info  on  the  selection  menu  for  the  addr^s 
"EnemyType"  -  info  on  the  selection  menu  for  the  enemy  type 
"EnemyActivity"  -  info  on  the  selection  menu  for  the  enemy 
activity 

"Direc"  -  info  on  the  selection  menu  for  the  direction 
"Obsint"  -  info  on  the  selection  menu  for  the  observer 
intentions 

"SpeedText"  -  widget  id  for  speed  text 
"NumText"  -  widget  id  for  number  text 
"UnitText"  -  widget  id  for  unit  text 
"dkTextl"-  widget  id  for  dkl  text 
"cikText2"-  widget  id  for  cik2  text 

4.5.20.3.2.8  Logic  flow.  Single  pass 

4.5.20.3.2.9  Data  structures.  None 

4.5.20.3.2.10  Local  data  files  or  database.  None 

4.5.20.3.2.11  Limitations.  None 


4.5,21  Sub'Level  CSC  reuse_calL 

The  following  paragraphs  imder  this  section  describe  the  relationship  of  the 
reuse_call  Sub-Level  C^  in  ttro:  s  of  data  flow  between  the  CSU’s  of  this 
Sub-level  CSC. 

4.5.21.1  CSU  reusead.moreCB 

The  reusead.moreCB  CSU  handles  the  callback  for  the  reusead  More 
pushbutton.  It  displays  additional  selectins  if  they  exist 

4.5.21.1.1  CSU  reusead.moreCB  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfuinction  of  a  helicopter  mission  eqmpment  package. 

4.5.21.1.2  CSU  reusead.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
reusead.moreCB  CSU. 
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4.5^1.12.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 


4.521.12.2 

Loeal  data  elements.  None 

4.521.12.3 

Interrupts  and  signals.  None 

4.521.1.2.4 

Algorithms.  None 

4.521.1.2.5 

Error  handling.  None 

4.5.21.12.6 

Data  conversion.  None 

4.5.21.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  reusead.moreCB  CSU: 

"ReuseAdd"  -  info  on  the  Reuse  address  selection  menu 

4.5.21.12.8 

Logic  flow.  Single  pass 

4.5.21.12.9 

Data  structures.  None 

4.5.21.12.10 

Local  data  files  or  database.  None 

4.5.21.12.11 

Limitations.  None 

4.5212  CSU  rea8cad_rotateCB 

The  reusead^tateCB  CSU  handles  the  callback  for  the  reusead  Rotate 
pushbutton.  It  changes  the  currently  selected  entry  to  the  next  entry  (die  first 
entry  if  it  is  at  die  eiid  already). 

4.5212.1  CSU  reasead_rotateCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4,5,21^  CSU  reusead.roUteCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
reusead.rotateCB  CSU. 

4.5.21.2.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS  :  . 

4.5.21.2.2.2  Local  data  elements.  None 

4.5.21.2.2.3  Interrupts  and  signals.  Norte 

4.5.21.2.2.4  Algorithms.  None 

4.5.21.2.2.5  Error  handling.  None 
4.5.21.2JL6  Data  conversion.  None 

4.5.21.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  reusead.rotateC6  CSU: 

"ReuseAdd"  •  info  on  Reuse  address  selection  menu 

4.5.21.2.2.8  Logic  flow.  Siitglepass 

4.5.21.2.2.9  Data  structures.  None 

4.5.21.2.2.10  Local  data  files  or  database.  None 

4.5.21.2.2.11  Limitations.  None 

4.5.213  CSU  PtttupReuse 

The  PutupReuse  CSU  will  create  the  Reuse  report  screen  if  necessary  and  will 
also  manage  the  screea 
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4.5,213.1  CSU  PutupReuse  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-inte^ace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.53133  CSU  PutupReuse  design* 

The  information  identified  below  represents  the  detailed  design  of  the 
PutupReuse  CSU. 

4.5.21.3.2.1  Input /output  data  elements. 

INPUTS:  None 
OUTPUTS:  None 


4.5.21.3.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"entries"  -  number  of  addresses 


4.5.21.3.2.3  Interrupts  and  signals.  None 
4.531.33.4  Algorithms.  None 
4.5.21.3.2.5  Error  handling.  None 
4.531.3.2.6  Data  conversion.  None 


4.531.33.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupReuse  CSU: 

"ReuseForm"  •  widget  id  of  reuse  form 
"ReuseAdd"  >  info  on  Reuse  address  selection  menu 
"addressList"  >  list  of  addresses 
"ReuseMoreLabel"  -  widget  id  of  More  label 
"ReuseMoreArrow"  -  widget  id  of  More  arrow 
"replyRag"  -  boolean;  is  tl^  a  reply 
"ReuseTmiForm"  widget  id  of  reuse  TMl  form 


4.5.21.3.2.8  Logic  flow.  Single  pass 
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4.5^1.3.2.9  Data  structures.  None 
4.5J213^.10  Local  data  files  or  riatahasp.  None 
4.5.21.3^.11  Limitations.  None 


4,5.22  Sub>Leve]  CSC  shotTmi.calL 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
shotTmi.call  Sub>Level  CSC  in  terms  of  data  flow  between  the  CSlTs  of  this 
Sub-level  CSC. 

4.5.22.1  CSU  ShotOearNRetCB 

The  ShotClearNRetCB  CSU  handles  the  callback  from  the  Clear  and  Return 
pushbutton.  It  will  clear  and  unmanage  the  Shot  window  and  remai\age  the 
Reports  window. 

4.5.22.1.1  CSU  ShotClearNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-inteirface  (MMl)  and 
system  behavior  which  emulate  the  digital  message  communicatioiu 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.22.1.2  CSU  ShotQearNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ShotClearNRetCB  CSU. 

4.5.22.12.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.522.12.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 
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"xmstr"  local  to  hold  a  XmString 


4.5^.1.2.3  Interrupts  and  signals.  None 

4.5.22.1.2.4  Algorithms.  Ncme 

4.5.22.1.2.5  Error  handUng.  None 

4.5.22.1.2.6  Data  COnVfirsm  None 


4.5.22.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ShotClearNKetCB  CSU: 

"ShotTmiForm'*  •  form  widget  containing  Shot  TMI 
"ShotForm"  -  form  widget  containing  Shot  Entry  area 
"cikLabel2"  -  label  widget 

4.5.22.1.2.8  Logic  flow.  Single  pass 

4.5.22.12.9  Data  structures.  None 


4.522.1.2.10  Local  data  files  or  database.  None 

4.522.1.2.11  Limitations.  None 


4.5222  CSU  ShotSaveNRetCB 

The  ShotSaveNRetCB  CSU  handles  the  callback  from  the  Save  and  Return 
pushbutton.  It  will  unmanage  the  Shot  window  and  remanage  the  Reports 
window. 

4.522.2.1  CSU  ShotSaveNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commimicatioits  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  aiui 
system  behavior  which  emulate  the  digital  message  commuiucations 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.222.2  CSU  ShotSaveNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ShotSaveNRetCB  CSU. 
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4.5.22.2.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contaixu  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.22.2.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nullChar"  null  character 


4.5.22.2.2.3 


i.  None 


4.5.22.2.2.4  Algorithms.  None 


4.5.22.2.2.5 


t.  Norte 


4.5.22.2.2.6 


sion.  None 


4.5.22.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ShotSaveNRetCB  CSU: 

"ShotTmiForm"  -  form  widget  containing  Shot  TMI 
"ShotForm"  -  form  widget  containing  Shot  Entry  area 
"cikLabel2"  -  label  widget 
"dkLabell"  -  label  widget 

4.5.22.2.2.8  Logic  flow.  Single  pass 


4.522.2.2.9 


None 


4.522.2.2.10 


None 


4.5.22.2.2.11  Limitations.  None 


4.5222  CSU  ShotSndRoutCB 

The  ShotSndRoutCB  CSU  handles  the  callback  from  the  Send  Routine 
pushbutton.  It  calls  ShotSend  with  priority  ROUTINE. 
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4.5.213.1  CSU  ShotSndRoutCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.53233  CSU  ShotSndRoutCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ShotSndRoutCB  CSU. 

4.5.22.3.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.22.3.2.2  Local  data  elements.  None 

4.5.22.3.2.3  Interrupts  and  signals.  None 
4.532.3.2.4  Algorithms.  None 

4.5.22.3.2.5  Error  handling.  None 

4.5.22.3.2.6  Data  conversion.  None 

4.5.22.33.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ShotSndRoutCB  CSU: 

'TRIORITY_ROUTINE"  -  define  for  priority  message 

4.5.22.33.8  Logic  flow.  Single  pass 
4.532.33.9  Data  structures.  None 
4.532.3.2.10  Local  data  files  or  database.  None 
4.5.22.3.2.11  Limitations.  None 
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4.5.22.4  CSU  ShotSend 

The  ShotSend  CSU  sends  a  message  with  a  given  priority.  It  retrieves  the 
data  from  the  text  entry  area  and  the  annotation  area  and  retrieves  the 
address  hrom  the  address  selection  menu.  It  then  sends  the  data  to  bldShot  to 
be  sent  out.  It  also  handles  the  case  that  the  message  is  a  reply  by  fixing  the 
address  to  that  from  the  message  being  replied  to.  If  the  message  is  a  Reuse 
and  Include,  the  included  message  will  also  be  sent  to  the  address  selected. 

4.5.22.4.1  CSU  ShotSend  requirements. 

The  ShotSend  CSU  satisfies  section  3.2.1.2.2.2.1,  3.2.1.2.2.3.6.1  and  3.2.1.2.23.6.1 
of  the  specific  requirments  of  the  DMCC  system. 

4.5.22.4.2  CSU  ShotSend  design. 

The  information  identified  below  represents  the  detailed  design  of  the 

ShotSend  CSU. 

4.5.22.4.2.1  Input/output  data  elements. 

INPUTS: 

"prio"  -  priority  of  the  message  being  sent 
OUTPUTS:  None 

4.5.22.4.2.2  Local  data  elements. 

"targetCEOI"  -  name  of  user  message  is  being  sent  to 


"annotation' 

'  -  text  of  aimotation  string 

4.5.22.4.2.3 

Interrupts  and  signals.  None 

4.5.22.4.2.4 

Algorithms.  None 

4.5.22.4.2.5 

Error  handling.  None 

4.5.22.4.2.6 

Data  conversion.  None 

4.5.22.4.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ShotSend  CSU: 

"ShotAdd"  -  information  on  the  Shot  address  selection  menu 
"reply  flag"  -  boolean;  is  this  a  reply 
"replyCEOI"  -  target  name  for  reply  call 
"reuseFlag"  -  boolean;  is  this  a  reuse  and  include 

4.5.22.4.2.8 

Logic  flow.  Single  pass 
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4.5.22.4.2.9 


s.  None 


4.5.22.4.2.10 


»  None 


4.5.22.4.2.11  Limitations.  None 


4.5,22.5  CSU  ShotSndUrgCB 

The  ShotSndUrgCB  CSU  handles  the  callback  from  the  Send  Urgent 
pushbutton.  It  calls  ShotSend  with  priority  URGENT. 

4.5.22.5.1  CSU  ShotSndUrgCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.22.5J1  CSU  ShotSndUrgCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ShotSndUrgCB  CSU. 

4.5.22.5.2.1  Inout/outout  data  elements. 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.22.5.2,2 


None 


4.5.22.5.2.3 


s.  None 


4.522.5.2.4  Algorithms.  None 


4.5.22.5.2.5 


ling.  None 


4.5.22.52.6 


None 


4.5.22.52.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ShotSiulUrgCB  CSU: 

"PRIORirY.URGENT"  -  define  for  urgent  priority 
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4.5.22.5.2.8  Logic  flow.  Single  pass 

4.5.22.5.2.9  Data  structures.  None 

4.5.22.5.2.10  Local  data  files  or  database.  None 

4.5.22.5.2.11  Limitations.  None 


4.5.22.6  CSUOearShot 

The  ClearShot  CSU  clears  all  the  entries  of  the  Shot  report  generation  screen. 

4.5.22.6.1  CSU  QearShot  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5JZ2.6.2  CSU  ClearShot  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ClearShot  CSU. 

4.5.22.62.1  Input/Qutput  data  elements. 

INPUTS: 

OUTPUTS:  None 

4.5.22.62.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nuUChar"  null  char 

4.5.22.6.2.3  Interrupts  and  signals.  None 

4.5.22.6.2.4  Algorithms.  None 
4.5.22.62.5  Error  handUng.  None 
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4.5.22.6.2.6  Data  conversion.  None 

4.5.22.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
theCIearShot  CSU: 

"ShotAdd"  -  info  on  the  selection  menu  for  the  address 
"EnemyT)rpe"  >  info  on  the  selection  menu  for  the  enemy  type 
"EnemyActivity"  *  info  on  the  selection  menu  for  the  enemy 
activity 

"Direc"  -  info  on  the  selection  menu  for  the  direction 
"Obsint"  -  info  on  the  selection  menu  for  the  observer 
intentions 

"SpeedText"  -  widget  id  for  speed  text 
"NumText"  -  widget  id  for  number  text 
"UnitText"  -  widget  id  for  unit  text 
"dkTextl"-  widget  id  for  dkl  text 
"cikText2"-  widget  id  for  cik2  text 

4.5.22.6.2.8  Logic  flow.  Single  pass 

4.5.22.6.2.9  Data  structures.  None 

4.5.22.6.2.10  Local  data  files  or  database.  None 

4.5.22.6.2.11  Limitations.  None 


4.5^  Sub-Level  CSC  shot.calL 

The  following  paragraphs  imder  this  section  describe  the  relationship  of  the 
shot.call  Sub-Level  C^  in  terms  of  data  flow  between  the  CSU’s  of  this  Sub- 
level  CSC. 


4.5.23.1  CSU  shotad.moreCB 

The  shotad.moreCB  CSU  handles  the  callback  for  the  shotad  More 
pushbutton.  It  displays  additional  selectins  if  they  exist. 

4.5.23.1.1  CSU  8hotad_moreCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4.5Jt3.1,2  CSU  shotad.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
shotad_moreCB  CSU. 

4.5.23.1.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 

4.5.23.1.2.2  Local  data  elements.  None 

4.5.23.1.2.3  Interrupts  and  signals.  None 
4.5.23.12.4  Algorithms.  None 

4.5.23.1.2.5  Error  handling.  None 

4.5.23.1.2.6  Data  conversion.  None 

4.5.23.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  shotad.moreCB  CSU: 

"ShotAdd"  •  info  on  the  Shot  address  selectimi  menu 

4.523.12.8  Logic  flow.  Single  pass 

4.523.12.9  Data  structures.  None 

4.5.23.12.10  Local  data  files  or  database.  None 

4.5.23.12.11  Limitations.  None 

4,5232  CSU  shotad.rotateCB 

The  shotad.rotateCB  CSU  handles  the  caUback  for  the  shotad  Rotate 
pushbutton.  It  changes  the  currently  selected  entry  to  the  next  entry  (the  first 
entry  if  it  is  at  the  ei^  already). 
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4.5.23^1  CSU  shotad.rotateCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.23.22  CSU  shotad.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
shotad_rotateCB  CSU. 

4.5.23.2.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  . 


4.5.23.2.2.2 

Local  data  elements.  None 

4.5.23.22.3 

Interrupts  and  signals.  None 

4.523.22.4 

Algorithms.  None 

4.523.2.2.5 

Error  handUng.  None 

4.5.23.22.6 

Data  conversion.  None 

4.5.23.22.7  Use  of  other  elements.  Other  elements  that  are  used  bv 
the  shotad.rotateCB  CSU: 

"ShotAdd"  -  info  on  Shot  address  selection  menu 

4.523.22.8 

Logic  flow.  Single  pass 

4.523.22.9 

Data  structures.  None 

4.5.23.22.10 

Local  data  files  or  database.  None 

4.5.23.2.2.11 

Limitations.  None 
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4.5,233  CSU  PutupShot 

The  PutupShot  CSU  will  aeate  the  Shot  report  screen  if  necessary  and  will 
also  manage  the  screen. 

4.5.233.1  CSU  PutupShot  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man*machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communicatioiis 
subfunction  of  a  helicopter  mission  equipment  package. 

4.53333  CSU  PutupShot  design. 

I'he  information  identified  below  represents  the  detailed  design  of  the 
PutupShot  CSU. 

4.533.33.1  Input/output  data  elements. 

INPUTS;  None 
OUTPUTS:  None 


4.533.33.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  argiunents  set  for  XtSetValues 
"args"  the  argiunents  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"entries"  -  number  of  addresses 


4.533.33.3  Interrupts  and  signals.  None 

4.533.33.4  Algorithms.  Ncme 

4.533.33.5  Error  handling.  None 
4.53333.6  Data  conversion.  None 


4.533.33.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupShot  CSU: 

"ShotForm"  -  widget  id  of  shot  form 
"ShotAdd"  -  info  on  Shot  address  selection  menu 
"addressList"  •  list  of  addresses 
"ShotMoreLabel"  •  widget  id  of  More  label 
"ShotMoreArrow"  >  widget  id  of  More  arrow 
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"replyRag"  -  bodean;  is  ^  a  reply 
"ShotTmiForm"  widget  id  of  sh^  TMI  form 

4.5  J332.8  Logic  flow.  Single  pass 

4.523.3.2.9  Data  stnichir^s.  None 

4.523.3.2.10  Local  data  files  or  database.  None 

4.523.3.2.11  Limitations.  None 


4.5.24  Sub-Level  CSC  splashTmLcalL 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
splashTmi_call  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of 
tius  Sub-level  CSC. 

4.524.1  CSU  SplashOearNRetCB 

The  SplashQearNRetCB  CSU  handles  the  callback  from  the  Qear  axui  Return 
pushbutton.  It  will  dear  and  unmaxuige  the  Splash  window  and  remanage 
the  Reports  window. 

4.524.1.1  CSU  SplashQearNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-intedace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  missitm  equipment  package. 

4.524.12  CSU  SplashQearNRetCB  design. 

The  iitformation  identified  below  represents  the  detailed  design  of  the 
SplashClearNRetCB  CSU. 

4.524.12.1  Input/output  data  elements. 

INPUTS: 

''w"  ccmtains  widget  id  of  button  pressed 
"client"  contains  client  dahi 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 
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4.5.24.1.2.2  Local  data  elcmgnts. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 

4.5.24.1.2.3  Interrupts  and  signals.  None 

4.5.24.1.2.4  Algorithms.  None 

4.5.24.1.2.5  Error  handling.  None 

4.5.24.1.2.6  Data  conversion.  None 

4.5.24.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SplashClearNRetCB  CSU: 

"SplashTmiForm"  -  form  widget  containing  Splash  TMI 
"SplashForm"  -  form  widget  containing  Splash  Entry  area 
"cikLabel2"  •  label  widget 

4.5.24.1.2.8  Logic  flow.  Single  pass 

4.5.24.1.2.9  Data  structures.  None 

4.5.24.1.2.10  Local  data  files  or  database.  None 

4.5.24.1.2.11  Limitations.  None 


4.5^4^  CSU  SplashSaveNRetCB 

The  SplashSaveNRetCB  CSU  handles  the  callback  from  the  Save  and  Return  . 
pushbutton.  It  will  unmanage  the  Splash  window  and  remanage  the  Reports 
window. 

4.5^4^!  CSU  SplashSaveNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 
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4.5,24.2,2  CSU  SplashSaveNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SplashSaveNRetCB  CSU. 

4.5.24.2.2.1  Input /output  data  elements. 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.24.2.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nullChar"  null  character 


4.5.24.2.2.3 


s.  None 


4.5.24.2.2.4  Algorithms.  None 


4.5.24.2.2.5 


i.  None 


4.524.2.2.6 


don.  None 


4.524.22.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SplashSaveNRetCB  CSU: 

"SplashTmiForm"  •  form  widget  containing  Splash  TMI 
"SplashForm"  •  form  widget  contaiiting  Splash  Entry  area 
"cikLabel2"  >  label  widget 
"dkLabell"  -  label  widget 

4.524.22.8  Logic  flow.  Single  pass 


4.524.22.9 


None 


4.5.24.2.2.10 


None 


4.524.22.11  Limitations.  None 
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4.5^43  CSU  SplashSndRoulCB 

The  SplashSndRoutCB  CSU  handles  the  callback  from  the  Send  Routine 
pushbutton.  It  calls  SplashSend  with  priority  ROUTINE. 

4.534L3.1  CSU  SplashSndRoutCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.2433  CSU  SplashSndRoutCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SplashSndRoutCB  CSU. 

4.5.24.3.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.24.33.2 

Local  data  elements.  None 

4.5.24.33.3 

Interrupts  and  signals.  None 

4.534.3.2.4 

Algorithms-  None 

4.534.33.5 

Error  handling.  None 

4.534.33.6 

Data  conversion.  None 

4.534.33.7  Use  of  other  elements.  Other  elements  that  are  used  bv 
the  SplashSndRoutCB  CSU: 

'TRIORTTY.ROUTINE"  -  define  for  priority  message 

4.5.24.3.2.8 

Logic  flow.  Single  pass 

4.5.24.3.2.9 

Data  structures.  None 

4.5.24.33.10 

Local  data  files  or  database.  None 
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4.5^4.3^2.11  Limitations.  None 


4.5,24.4  CSU  SplashSend 

The  SplashSend  CSU  sends  a  message  with  a  given  priority.  It  retrieves  the 
data  ^om  the  text  entry  area  and  the  annotation  area  and  retrieves  the 
address  from  the  address  selection  menu.  It  then  sends  the  data  to  bldSplash 
to  be  sent  out.  It  also  handles  the  case  that  the  message  is  a  reply  by  hxing  the 
address  to  that  from  the  message  being  replied  to.  If  the  message  is  a  Reuse 
and  Include,  the  included  message  will  alw  be  sent  to  the  address  selected. 

4.5.24.4.1  CSU  SplashSend  requirements. 

The  SplashSend  CSU  satisfies  section  3.2.1. 2.2.2.1,  3.2.1.2.2.3.6.1  and 

3.2.1.2.2.3.6.1  of  the  specific  requirments  of  the  DMCC  system. 

4.5.24.4.2  CSU  SplashSend  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SplashSend  CSU. 

4.5.24.4.2.1  Input/output  data  elements. 

INPUTS: 

"prio"  •  priority  of  the  message  being  sent 
OUTPUTS:  None 


4.5.24.4.2.2  Local  data  elements. 

"targetCEOI"  -  name  of  user  message  is  being  sent  to 
"annotation"  -  text  of  aniu}tation  string 


4.524.4.2.3  Interrupts  and  signals.  None 

4.524.42.4  Algorithms.  None 

4.524.42.5  Error  handling.  None 
4.5.24.42.6  Data  conversion.  None 


4.5.24.42.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SplashSend  CSU: 

"SplashAdd"  >  information  on  the  Splash  address  selection  menu 
"reply  flag"  -  boolean;  is  this  a  reply 
"replyCEOr  -  target  name  fear  reply  call 
"reuseFlag"  •  boolean;  is  this  a  reuse  and  include 
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4.5.24.4.2.8  Logic  flow.  Single  pass 

4.5.24.4.2.9  Data  structures.  None 

4.5.24.4.2.10  Local  data  files  or  database.  None 

4.5.24.4.2.11  Limitations.  None 


4.5^4.5  CSU  SplashSndUigCB 

The  SplashSndUrgCB  CSU  handles  the  callback  the  Send  Urgent 
pushbutton.  It  calls  SplashSend  with  priority  URGENT. 

4.5.24.5.1  CSU  SplashSndUigCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.24.5.2  CSU  SplashSndUrgCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SplashSndUrgCB  CSU. 

4.5.24.52.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  None 

4.524.52.2  Local  data  elements.  None 

4.5.24.52.3  Interrupts  and  signals.  None 

4.5.24.52.4  Algorithms.  None 

4.524.52.5  Error  handUng.  None 

4.524.52.6  Data  conversion.  None 
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4.5.24.5.2.7  Use  of  othgr  elements.  Other  elements  that  are  used  by 
the  SplashSndUrgCB  CSU: 

"PRIORirY.URGENT"  -  define  for  urgent  priority 

4.5.24.5.2.8  Logic  flow.  Single  pass 

4.5.24.5.2.9  Data  structures.  None 

4.5.24.5.2.10  Local  data  files  or  database.  None 

4.5.24.5.2.11  Limitations.  None 


4.5J4.6  CSU  aearSplash 

The  ClearSplash  CSU  clears  all  the  entries  of  the  Splash  report  generation 
screen. 

4.5.24.6.1  CSU  QearSplash  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man*machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.24.6^1  CSU  QearSplash  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
ClearSplash  CSU. 

4.5.24.6.2.1  Input/output  data  elements. 

INPUTS: 

OUTPUTS:  None 

4.5.24.6.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nuUChar"  null  char 

4.5.24.6.2.3  Interrupts  and  signals.  None 
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4.5^4.6.2.4  Algorithms.  None 

4.5.24.6.2.5  Error  handling.  None 

4.5.24.6.2.6  Data  conversion.  None 

4.5.24.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ClearSplash  CSU: 

"SplashAdd"  •  info  on  the  selection  menu  for  the  address 
"EnemyType"  >  info  on  the  selection  menu  for  the  enemy  type 
"Enemy Activity"  -  info  on  the  selection  menu  for  the  enemy 
activity 

"Direc"  -  info  on  the  selection  menu  for  the  direction 
"Obsint"  -  info  on  the  selection  menu  for  the  observer 
intentions 

"SpeedText"  -  widget  id  for  speed  text 
"NumText"  -  widget  id  for  number  text 
"UnitText"  -  widget  id  for  unit  text 
"dkTextl"-  widget  id  for  dkl  text 
"cikText2"-  widget  id  for  cik2  text 

4.524.6.2.8  Logic  flow.  Single  pass 

4.5.24.6.2.9  Data,  StTUCtUTfiS.  None 

4.5.24.62.10  Local  data  files  or  database.  None 

4.524.6.2.11  Limitations  None 


4.525  Sub>LevelCSC  splash.calL 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
splash  call  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSLTs  of  this 
Sub-level  CSC. 

4.525.1  CSU  splashad.moreCB 

The  splashad.moreCB  CSU  handles  the  callback  for  the  splashad  More 
pushbutton.  It  displays  additional  selectins  if  they  exist. 
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4.5^5.1.1  CSU  splashad.moreCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.25.1.2  CSU  splashad.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
splashad.moreCB  CSU. 

4.5.25.1.2.1  Input /output  data  elements. 

INfPUTS: 

"w"  contains  widget  id  of  button  prised 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 


4.5.25.1.2.2 


None 


4.5.25.1.2.3 


5.  None 


4.5.25.1.2.4  Algorithms.  None 


4.5.25.1.2.5 


None 


4.525.12.6 


None 


4.5.25.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by. 
the  splashad.moreCB  CSU: 

"SplashAdd"  -  info  on  the  Splash  address  selection  menu 
4.525.12.8  Logic  flow.  Single  pass 


4.525.12.9 


5.  None 


4.5.25.1.2.10 


None 


4.5.25.1.2.11  Limitations.  None 
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4.5^5^  CSU  splashad_rotateCB 

The  splashad.rotateCB  CSU  handles  the  callback  for  the  splashad  Rotate 
pushbutton.  It  changes  the  currently  selected  entry  to  the  next  entry  (the  first 
entry  if  it  is  at  the  end  already). 

4.5.25^1  CSU  splashad.rotatcCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.25JL2  CSU  splashad.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
splashad.rotateCB  CSU. 

4.5.25.2.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  caU  reason 
OUTPUTS:  . 


4.5.25.2.2.2  Local  data  elements.  None 

4.5.25.2.2.3  Interrupts  and  signals.  None 

4.5.25.2.2.4  Algorithms.  None 

4.5.25.2.2.5  Error  handling.  None 
4.525.2.2.6  Data  conversion.  None 

4.525.22.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  splashad.rotateCB  CSU: 

"SplashAdd"  -  info  on  Splash  address  selection  menu 

4.525.22.8  Logic  flow.  Single  pass 
4.5.25.2.2.9  Data  structures.  None 
4.5.25.22.10  Local  data  files  or  database.  None 
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4.5^.2^.ll  Limitations-  None 


4.5J1S3  CSU  PutupSplash 

The  PutupSplash  CSU  will  create  the  Splash  report  screen  if  necessary  and 
will  also  manage  the  screen. 

4.5.253.1  CSU  PutupSplash  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.52532  CSU  PutupSplash  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
PutupSplash  CSU. 

4.5.25.32.1  Input/output  data  elements. 

INPUTS:  None 
OUTPUTS:  None 


4.525.32.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"entries"  -  number  of  addresses 


4.52532.3  Interrupts  and  signals.  None 

4.52532.4  Algorithms.  None 
4.525.32.5  Error  handling.  None 

4.52532.6  Data  conversion.  None 

4.52532.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupSplash  CSU: 

"SplashForm"  -  widget  id  of  splash  form 
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"SplashAdd"  *  info  on  Splash  address  selection  menu 
"addressList"  -  list  of  addresses 
"SplashMoreLabel"  -  widget  id  of  More  label 
"SplashMoreArrow"  -  widget  id  of  More  arrow 
"replyFlag"  -  boolean;  is  this  a  reply 
"SplashTmiForm"  widget  id  of  splash  TMI  form 

4.5.25.3.2.8  Logic  flow.  Single  pass 

4.5.25.3.2.9  Data  structures.  None 
4.525.3.2.10  Local  data  files  or  database.  None 
4.5.25.3.2.11  Limitations.  None 


4.5.26  Sub'Level  CSC  spotTmi_caIl. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
spotTmi.call  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSUs  of  this 
Sub-level  CSC. 

4.526.1  CSU  SpotOearNRetCB 

The  SpotClearNRetCB  CSU  handles  the  callback  from  the  Clear  and  Return 
pushbutton.  It  will  clear  and  unmanage  the  Spot  window  and  remanage  the 
Reports  window. 

4.526.1.1  CSU  SpotOearNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.5.26.12  CSU  SpotOearNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SpotClearNRetCB  CSU. 

4.5.26.1.2.1  Input/output  data  elements. 

INPUTS: 

"'w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
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OUTPUTS:  None 
4.5^6.1^.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
4.5^6.1.2.3  Interrupts  and  signals.  None 
4.5^6.1.2.4  Algorithms.  None 

4.5.26.1.2.5  Error  handling.  Ncme 

4.5.26.1.2.6  Data  conversion.  None 

4.5.26.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SpotClearNRetCB  C5U: 

"SpotTmiForm"  -  form  widget  containing  Spot  TMI 
"SpotForm"  -  form  widget  containing  Spot  Entry  area 
"cikLabel2"  •  label  widget 

4.5.26.1.2.8  Logic  flow.  Single  pass 

4.5.26.1.2.9  Data  structures.  None 

4.5.26.1.2.10  Local  data  files  or  database.  None 
4.5.26.12.11  Limitations.  None 


4.5262  eSU  SpotSaveNRetCB 

The  SpotSaveNRetCB  CSU  handles  the  callback  from  the  Save  and  Return 
pushbutton.  It  will  uiunanage  the  Spot  window  and  remanage  the  Reports 
window. 

42262.1  CSU  SpotSaveNRetCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4.5JZ6JL2  CSU  SpotSaveNRetCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SpotSaveNRetCB  CSU. 

4.5.26.2.2.1  Input /output  data  plgmimK 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 
i.5.26.22.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nullChar"  null  character 

4.5.26.2.2.3  Interrupts  and  signals.  None 

4.5.26.2.2.4  Algorithms.  None 

4.5.26.2.2.5  Error  handling.  None 

4.5.26.2.2.6  Data  conversion.  None 

4.5.26.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SpotSaveNRetCB  CSU: 

"SpotTmiForm"  -  form  widget  cemtaining  Spot  TMI 
"SpotForm"  >  form  widget  containing  Spot  Entry  area 
"cikLabel2"  >  label  widget 
"dkLabell"  -  label  widget 

4.5.26.22.8  Logic  flow.  Single  pass 

4.526.22.9  Data  structures.  None 

4.526.22.10  Local  data  files  or  database.  None 
4.52622.11  Limitations.  None 
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4.5.26J  CSU  SpotSndRoutCB 

The  SpotSndRoutCB  CSU  handies  the  callback  from  the  Send  Routine 
piishbuttoit  It  calls  SpotSend  with  priority  ROUTINE. 

4.S26J.1  CSU  SpotSndRoutCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.263.2  CSU  SpotSndRoutCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SpotSndRoutCB  CSU. 

4.5.26.3.2.1  Input/output  data  elements. 

INPUTS: 

“W  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.26.3.2.2  Local  data  elements.  None 

4.5.26.3.2.3  Interrupts  and  signals.  None 
4.536.3.2.4  Algorithms.  None 
4.5.26.3.2.5  Error  handling.  None 

4.536.33.6  Data  conversion.  None 

4.536.33.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SpotSndRoutCB  CSU: 

'TRIORITY_ROUTINE"  -  define  for  priority  message 

4.536.33.8  Logic  flow.  Single  pass 
4.536.3.2.9  Data  structures.  None 
4.536.33.10  Local  data  files  or  database.  None 
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4.5.26.3.2.11  Limitations.  None 


4.5^6.4  CSU  SpotSend 

The  SpotSend  CSU  sends  a  message  with  a  given  priority.  It  retrieves  the  data 
from  the  text  entry  area  and  the  annotation  area  and  retrieves  the  address 
hrom  the  address  selection  menu.  It  then  sends  the  data  to  bldSpot  to  be  sent 
out.  It  also  handles  the  case  that  the  message  is  a  reply  by  fixing  the  address  to 
that  from  the  message  being  replied  to.  If  the  message  is  a  Reuse  and  Include, 
the  included  message  %vill  also  be  sent  to  the  address  selected. 

4.5.26.4.1  CSU  SpotSend  requirements. 

The  SpotSend  CSU  satisfies  section  3.2.1.2.2.2.1, 3.2.1.2J23.6.1  and  3.2.1.2.23.6.1 
of  the  specific  requirments  of  the  DMCC  system. 

4.5.26.4.2  CSU  SpotSend  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SpotSend  CSU. 

4.5.26.4.2.1  Input /output  data  elements. 

INPUTS: 

"prio"  -  priority  of  the  message  being  sent 
OUTPUTS:  None 

4.5.26.4.2.2  Local  data  elements. 

"targetCEOI"  •  name  of  user  message  is  being  sent  to 
"annotation"  -  text  of  annotation  string 
"ObserverLocation"  -  location  of  observer 
'TargetQuantity"  •  quantity  of  targets 
"Observerintentions"  -  intentions  of  observers 
'TargetType"  -  type  of  target 

'Target  Activity"  -  type  of  activity 
"locn.string"  -  string  containing  location  information 
"num.string"  -  string  containing  number  information 
"num"  •  integer  containing  number  information 
"speed.string"  -  string  containing  speed  information 
"speed"  -  integer  containing  the  speed 
'TargetSpeed"  -  speed  of  the  tar^t 
'TargetLocation"  -  location  of  the  target 
'TargetUnit"  >  pointer  to  the  strii^  of  the  target  unit 

4.5.26.4.2.3  Interrupts  and  signals.  None 
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4.526A.1A  Algorithms.  N<»ie 
4.5^6.42.5  Error  handling.  None 
4.5.26.4.2.6  Data  conversion.  None 

4.5.26.42.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SpotSend  CSU: 

"SpotAdd"  -  information  on  the  Spot  address  selection  menu 
"reply  flag"  -  boolean;  is  this  a  reply 
"replyCEOI"  -  target  name  for  reply  call 

"Enemy Activity"  -  information  on  the  Enemy  Activity  selection  menu 
"Obsint"  -  information  on  the  Obsover  Intentions  selection  menu 
"reuseFlag"  -  boolean;  is  this  a  reuse  and  include 

4.5.26.4.2.8  Logic  flow.  Single  pass 

4.5.26.4.2.9  Data  structures.  None 

4.5.26.4.2.10  Local  data  files  Or  database.  None 
4.526.42.11  Limitations.  None 


4.526.5.  CSU  SpotSndUigCB 

The  SpotSndUrgCB  CSU  handles  the  callback  from  the  Send  Urgent 
pushbutton.  It  calls  SpotSend  with  priority  URGENT. 

4.526.5.1  CSU  SpotSndUigCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  dietail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  halicopter  mission  equipment  package. 

4.526.52  CSU  SpotSndUigCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SpotSndUrgCB  CSU. 

4.5.26.5.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 


Page  269 


4.5^6.6  CSU  QearSpot 

The  QearSpot  CSU  dears  all  the  entries  of  the  Spot  report  generation  screen. 
4.5^6.6.1  CSU  QearSpot  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.26.6.2  CSU  QearSpot  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
QearSpot  CSU. 
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4.5.26.6.2.1  Input/output  data  elements. 
INPUTS: 

OUTPUTS:  None 


4.5.26.6.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  argtunents  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
"nuUChar"  null  char 


4.5.26.6.2.3  Interrupts  and  signals.  None 

4.5.26.6.2.4  Algorithms.  None 

4.5.26.6.2.5  Error  handling.  None 

4.5.26.6.2.6  Data  conversion.  None 


4.5.26.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  ClearSpot  CSU: 

"SpotAdd"  -  info  on  the  selection  menu  for  the  address 
"EnemyType"  -  info  on  the  selection  menu  for  the  enemy  type 
"EnemyActivity"  -  info  on  the  selection  menu  for  the  enemy 
activity 

"Direc"  -  info  on  the  selection  menu  for  the  direction 
"Obslnt"  -  info  on  the  selection  menu  for  the  observer 
intentions 

"SpeedText"  -  widget  id  for  sp>eed  text 
"NumText"  -  widget  id  for  number  text 
"UnitText"  -  widget  id  for  unit  text 
"dkTextl"-  widget  id  for  dkl  text 
"cikText2"-  widget  id  for  cik2  text 


4.526.6.2.8  Logic  flow.  Single  pass 

4.5.26.62.9  Data  structures.  None 


4.5.26.6.2.10  Local  data  files  or  database.  None 


4.5.26.62.11  Limitations.  None 
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4.5.26.7  CSU  KPH.MPHCB 

The  KPH_MPHCB  CSU  hancUes  the  caUback  from  the  KPH/MPH 
pushbutton.  It  toggles  the  units  the  speed  is  used  as.  In  addition,  it  changes 
the  label  after  the  entry  area  to  be  the  currently  chosen  tmits  and  the  label  of 
the  pushbutton  to  the  units  currently  not  chosen. 

4.5.26.7.1  CSU  KPH.MPHCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.26.7.2  CSUKPH.MPHCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
KPH.MPHCB  CSU. 

4.5.26.7.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
“client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  None 


4.5.26.7.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 

4.5.26.7.2.3  Interrupts  and  signals.  None 
4.526.7.2.4  Algorithms.  None 

4.5.26.7.2.5  Error  handling.  None 

4.5.26.7.2.6  Data  conversion.  None 


4.5.26.7.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
theKPH.MPHCB  CSU: 

"SpotTmiKPH"  -  widget  id  for  KPH  button 
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"SpeedLabel"  -  widget  id  for  KPH  label 

4.5.26.7.2.8  Logic  flow.  Single  pass 

4.5.26.7.2.9  Data  structures.  None 

4.5.26.7.2.10  Local  data  files  or  database.  None 

4.5.26.7.2.11  Limitations.  None 


4.5JI7  Sub>Level  CSC  spot.calL 

The  following  paragraphs  tmder  this  section  describe  the  relationship  of  the 
spot.call  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of  this  Sub- 
level  CSC. 

4.5^7.!  CSU  enemyAcdvity.moreCB 

The  enemy Activityad.moreCB  CSU  handles  the  callback  for  the 
enemyActivityad  More  pushbutton.  It  displays  additional  selectins  if  they 
exist. 

4.5^7.1.1  CSU  enemyActivity.moreCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5J17.1.2  CSU  enemyActivity.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
enemy Activity.moreCB  CSU. 

4.5.27.1.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.27.1.2.2  Local  data  elements. 

"argent"  keeps  track  of  the  ntunber  of  arguments  set  for  XtSetVaiues 
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"args"  the  arguments  set  for  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  local  to  hold  a  XmString 
4.5.27.1^.3  Interrupts  and  signals.  None 

4.5.27.1.2.4  Algorithms.  None 

4.5.27.1.2.5  Error  handling.  None 

4.5.27.1.2.6  Data  conversion.  None 

4.5.27.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  enemy Activity^moreCB  CSU: 

"EnemyActivity"  -  info  on  Enemy  Activity  selection  menu 

4.5.27.1.2.8  Logic  flow.  Single  pass 

4.5.27.1.2.9  Data  structures.  None 

4.5.27.1.2.10  Local  data  files  or  database.  None 

4.5.27.1.2.11  Limitations.  None 


CSU  enemyActivity.roUteCB 

The  enemyActivityad.rotateCB  CSU  handles  the  callback  for  the 
enemy Activityad  Rotate  pushbutton.  It  changes  the  currently  selected  entry 
to  the  next  entry  (the  first  entry  if  it  is  at  the  end  already). 

4.5.27,2.1  CSU  enemy  Activity.roUteCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.52722  CSU  enemyActivity.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
enemy Activity_rotateCB  CSU. 
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4.5.27.22.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 


4.5.27.2.2.2 

Local  data  elements.  None 

4.5.27.2.2.3 

Interrupts  and  signals.  None 

4.5.27.2.2.4 

Algorithms.  None 

4.5.27.2.2.5 

Error  handling.  None 

4.5.27.2.2.6 

Data  conversion.  None 

4.5.27.2.2.7  Use  of  other  elements.  Other  elements  that  are  used  hy 
the  enemyActivity_rotateCB  CSU: 

"Enemy Activity"  -  info  on  the  enemy  activity  selection  menu 

4.5.27.2.2.8 

Logic  flow.  Single  pa.ss 

4.5.27.2.2.9 

Data  structures.  None 

4.5.27.2.2.10 

Local  data  files  or  database.  None 

4.5.27.2.2.11 

Limitations.  None 

4.5^73  CSU  enemyT3rpe.roUteCB 

The  enemyT3rpead_rotateCB  CSU  handles  die  callback  for  the  enemyTypead 
Rotate  pushbutton.  It  changes  the  currently  selected  entry  to  the  next  entry 
(the  first  entry  if  it  is  at  the  end  already). 

4L5.273.1  CSU  enemyType.rotatcCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMl)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4.5.27 JJZ  CSU  enemyType.foUteCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
enemyType_rotateCB  CSU. 

4.5.27.3.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  . 

4.5.27.3.2.2  Local  data  elements.  None 

4.5.27.3.2.3  Interrupts  and  signals.  None 

4.5.27.3.2.4  Algorithms.  None 

4.5.27.3.2.5  Error  handling.  None 

4.5.27.3.2.6  Data  conversion.  None 

4.5.27.3.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  enemyType_rotateCB  CSU: 

"EnemyType"  -  iitfo  on  the  Enemy  Type  selection  menu 
"spotTime"  -  time  of  last  selection 

4.5.27.3.2.8  Logic  flow.  Single  pass 

4.5.27.32.9  Data  structures.  None 

4.5.27.32.10  Local  data  files  or  database.  None 
4.527.32.11  Limitations.  Ncme 


4327.4  CSU  obsInt^rotateCB 

The  obsintad  jrotateCB  CSU  handles  the  callback  for  the  <^slntad  Rotate 
pushbutton.  It  changes  the  currently  selected  entry  to  the  next  entry  (die  first 
entry  if  it  is  at  the  erd  already). 
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4.5.27.4.1  CSU  obsInt.rotateCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.27.4.2  CSU  obsInt.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
obsInt_rotateCB  CSU. 

4.5.27.4.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 

4.5.27.4.2.2  Local  data  elements.  None 

4.5.27.4.2.3  Interrupts  and  signals.  None 

4.5.27.4.2.4  Algorithms.  None 

4.5.27.4.2.5  Error  handling.  None 

4.5.27.4.2.6  Data  conversion.  None 

4.5.27.4.2.7  Use  of  other  elements.  Other  elements  that  are  used  by. 
the  obsInt.rotateCB  CSU: 

4.5.27.4.2.8  Logic  flow.  Single  pass 

4.5.27.4.2.9  Data  structures.  None 

4.5.27.4.2.10  Local  data  files  or  database.  None 

4.5.27.4.2.11  Limitations.  None 
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4.5.27.5  CSU  spotad.moreCB 

The  spotad.moreCB  CSU  handies  the  callback  for  the  spotad  More 
pushbutton.  It  displays  additional  selectins  if  they  exist 

4.5.27.5.1  CSU  spotad.morcCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commuiucations  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.27.5.2  CSU  spotad.moreCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
spotad_moreCB  CSU. 

4.5.27.5.2.1  Input /output  data  elements. 

INPUTS: 

"w  "  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 


4.5.27.5.2.2  Local  data  elements.  None 


4.5.27.5.2.3  Interrupts  and  signals.  None 

4.5.27.5.2.4  Algorithms.  None 

4.5.27.5.2.5  Error  handling.  None 

4.5.27.5.2.6  Data  conversion.  None 

4.527.5.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  spotad_moreCB  CSU: 

"SpotAdd"  -  info  cm  the  Spot  address  selection  menu 

4.5.27.52.8  Logic  flow.  Single  pass 
4.527.52.9  Data  structures.  None 


4.527.52.10  Local  data  files  or  database.  None 
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4.5.27.5J1.11  Limitations.  Ncme 


43^7.6  CSU  spotad.rotatcCB 

The  spotad.rotateCB  CSU  handles  the  callback  for  the  spotad  Rotate 
pushbutton.  It  changes  the  currently  selected  entry  to  die  next  entry  (the  first 
entry  if  it  is  at  the  erd  abeady). 

4.5.27.6.1  CSU  spotad.rotateCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-inte^ace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.5.27.6.2  CSU  spotad_rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
spotad.rotateCB  CSU. 

4.5.27.6.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 


4.5.27.6.2.2  Local  data  elements.  None 
4.5.27.62.3  Interrupts  and  signals.  None 

4.527.62.4  Algorithms.  Norte 

4.527.62.5  Error  handUng.  None 

4.527.62.6  Data  conversion.  None 

4.527.62.7  Use  of  other  elements.  Other  eleixtents  that  are  used  by 
the  spotad_rotateCB  CSU: 

"SpotAdd"  -  info  on  Spot  address  selection  menu 

4.5.27.62.8  Logic  flow.  Siitglepass 
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4.5^7.62.9  Data  structures.  None 

4.527.6.2.10  Local  data  filgs  or  database.  None 

4.527.6.2.11  Limitations.  None 


4.527.7 


CSU  diiec_roUteCB 


The  direcad.rotateCB  CSU  handles  the  callback  for  the  direcad  Rotate 
pushbutton.  It  changes  the  currently  selected  entry  to  the  next  entry  (the  first 
entry  if  it  is  at  the  ei^  already). 

4.527.7.1  CSU  direc.rotateCB  requitements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package- 

4.527.72  CSU  direc.rotateCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
direc.rotateCB  CSU. 

4.527.72.1  Input/output  data  elements. 

INPUTS: 

"yt”  contains  widget  id  of  button  pressed 
"client''  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  . 

4.527.72.2  Local  data  elements.  None 
4527.722  Interrupts  and  signals.  None 
4.527.7.2.4  Algorithms.  None 
4.527.72.5  Error  handUng.  None 
4.527.7.2.6  Data  conversioiL  None 

4.527.72.7  Use  of  other  elements.  Ofiier  elements  that  are  used  by 
the  direc.rotateCB  CSU: 
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"Direc"  •  info  on  the  Direction  selection  menu 
4.527.7.2.8  Lope  flow.  Single  pass 
4.527.72.9  Data  structures.  None 

4.5.27.7.2.10  Local  data  files  or  databiae.  None 

4.5.27.7.2.11  Limitations.  None 


4.527.8  eSU  PutupSpot 

The  PutupSpot  eSU  will  create  the  Spot  report  screen  if  necessary  and  will 
also  manage  the  screen. 

4.527.8.1  eSU  PutupSpot  requirements. 

This  eSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.527.82  eSU  PutupSpot  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
PutupSpot  CSU. 

4.527.82.1  Input/output  data  elements. 

INPUTS:  None 

OUTPUTS:  None 

4.527.82.2  Local  data  elements. 

"argent"  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  the  arguments  set  fev  XtSetValues 

"argok"  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 

call 

"xmstr"  local  to  hold  a  XmString 
"entries"  -  number  of  addresses 

4.527.82.3  Interrupts  and  signals.  None 

4.527.82.4  Algorithms.  Ntme 
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4.5^7.8.2.5  Error  handling.  None 
4.5^7.8^.6  Data  conversinn.  None 

4.5.27.8^.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  PutupSpot  CSU: 

"SpotForm"  -  widget  id  of  spot  form 
"SpotAdd"  -  info  on  Spot  address  selection  menu 
"addressList"  -  list  of  addresses 
"SpotMoreLabel"  •  widget  id  of  More  label 
"SpotMoreArrow"  -  widget  id  of  More  arrow 
"replyFlag"  -  boolean;  is  this  a  reply 
"SpotTmiForm"  widget  id  of  spot  TMI  form 

4.5.27.8.2.8  Logic  flow.  Single  pass 

4.5.27.8.2.9  Data  structures.  None 
4.527.8.2.10  Local  data  files  or  database.  None 
4.527.82.11  Limitations.  None 


4.528  Sub-Level  CSC  sysMainCB. 

The  following  paragraphs  imder  this  section  describe  the  relationship  of  the 
sysMainCB  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSlTs  ^  this 
Sub-level  CSC. 


4.528.1  CSU  SysMainMsgsCB 

The  SysMainMsgsCB  CSU  handles  the  callback  for  bringing  up  the  Msgs 
screen. 

4.528.1.1  CSU  SysMainMsgsCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.28.12  CSU  SysMainMsgsCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SysMainMsgsCB  CSU. 
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4.5.28.1.2.1  Input/output  data  elemgnK 
INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 

4.5.28.1.2.2  Local  data  elements.  None 

4.5.28.1.2.3  Interrupts  and  signals.  None 

4.5.28.1.2.4  Algorithms.  None 

4.5.28.1.2.5  Error  handling.  None 

4.5.28.1.2.6  Data  conversion.  None 

4.5.28.1.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SysMainMsgsCB  CSU: 

"sysMainTmi"  •  widget  id  of  TMI  area  of  s3rsMain  form 
"sysMainForm"  -  widget  id  of  entry  area  of  sysMain  form 

4.5.28.1.2.8  Logic  flow.  Single  pass. 

4.5.28.1.2.9  Data  structures.  None 

4.5.28.1.2.10  Local  data  files  or  database.  None 

4.5.28.1.2.11  Limitations.  None 


4.5.28,2  CSU  SysMainRpitCB 

The  SysMainRprtCB  CSU  handles  the  callback  for  bringing  up  the  Rprt 
screen. 

4.5JI8JL1  CSU  SysMainRprtCB  requirements 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine*interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4.5^,2,2  CSU  SysMainRpitCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SysMamRprtCB  CSU. 

4.5.28.2.2.1  Input/output  data  glgmimK. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 


OUTPUTS:  None 

4.5.28.2.2.2  Local  data  elements.  None 

4.5.28.2.2.3  Interrupts  and  signals.  None 

4.5.28.2.2.4  Algorithms.  None 

4.5.28.2.2.5  Error  handling.  None 

4.5.28.2.2.6  Data  conversion.  None 

4.5.28.22.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SysMainRprtCB  CSU: 

"sysMainTmi"  >  widget  id  of  TMI  area  of  sysMain  form 
"sysMainForm"  >  widget  id  of  entry  area  of  sysMain  form 

4.528.22.8  Logic  flow.  Single  pass. 

4.528.2.2.9  Data  structures.  None 

4.528.22.10  Local  data  files  or  database.  None 

4.52822.11  Limitations.  None 


4.5283  CSU  SysMainAddUstCB 

The  SysMainAddUstCB  CSU  handles  tlw  callback  for  bringing  up  the  Addlist 
screen. 
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4.5.28  J.1  CSU  SysMainAddListCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.283JI  CSU  SysMainAddListCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SysMainAddListCB  CSU. 

4.5.28.3.2.1  Input /output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.28.3.2.2  Local  data  elements.  None 

4.5.28.3.2.3  Interrupts  and  signals.  None 

4.5.28.3.2.4  Algorithms.  None 

4.5.28.3.2.5  Error  handling.  None 

4.5.28.3.2.6  Data  conversion.  None 

4.5.28.3.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SysMainAddListCB  CSU: 

"sysMainTmi"  -  widget  id  of  TMI  area  of  sysMain  form 
"sysMainForm"  -  widget  id  of  entry  area  of  sysMain  form 


4.5.28.32.8  Logic  flow.  Single  pass. 
4.528.32.9  Data  structures.  None 
4.5.28.32.10  Local  data  files  or  database.  None 


4.5.28.3.2.11  Limitations.  None 
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4.5.28.4  CSU  SysMainGrpUstCB 

The  SysMainGrpUstCB  CSU  handles  the  callback  for  bringing  up  the  GrpUst 
screen. 

4.5.28.4.1  CSU  SysMainGrpUstCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.5.28.4.2  CSU  SysMainGrpListCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SysMainGrpUstCB  CSU. 

4.5.28.4.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.28.4.2.2  Local  data  elements.  None 

4.5.28.4.2.3  Interrupts  and  signals.  None 
4.528.4.2.4  Algorithms.  None 
4.5.28.4.2.5  Error  handling.  None 
4.528.42.6  Data  conversion.  None 

4.5.28.42.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SysMainGrpUstCB  CSU: 

"sysMainTmi"  -  widget  id  of  TMI  area  of  sysMain  form 
"sysMamForm"  -  widget  id  of  entry  area  of  sysMain  form 

4.5.28.4.2.8  Logic  flow.  Single  pass. 

4.5.28.4.2.9  Data  structures.  None 
4.5.28.42.10  Local  data  files  or  database.  None 
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4.5.28.4.2.11  Limitations.  None 


4.5^5  CSU  SysMainLocLisiCB 

The  SysMainLocListCB  CSU  handles  the  callback  for  bringing  up  the  LocList 
screen. 

4.5.28,5.1  CSU  SysMainLocListCB  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.5.28.52  CSU  SysMainLocListCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SysMainLocListCB  CSU. 

4.5.28.5.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.528.5.2.2  Local  data  elements.  None 

4.528.52.3  Interrupts  and  signals.  None 

4.528.52.4  Algorithms.  N(me 

4.528.52.5  Error  handling.  None 
4328.52.6  Data  conversion.  None 

4.5.28.52.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SysMainLocListCB  CSU: 

"sysMainTmi"  -  widget  id  of  TMI  area  of  sysMain  form 
"sysMainForm"  -  widget  id  of  entry  area  sysMain  form 

4.528.52.8  Logic  flow.  Single  pass. 
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4.5^.5J2.9  Data  structures.  Ncme 
4.5^.5^.10  Local  data  files  or  database.  None 
4.5.28.5^.11  Limitations.  None 


4.5,28.6  eSU  S3rsMainLogoutCB 


4.5.28.6.1  eSU  SysMainLogoutCB  requirements. 

This  eSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.28.6.2  eSU  SysMainLogoutCB  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
SysMainLogoutCB  CSU. 

4.5.28.6.2.1  Input/output  data  elements. 

INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  ’ient  data 

"call"  contains  X  V.'indows  data  about  the  call  reason 
OUTPUTS:  None 


4.5.28.6.2.2  Local  data  elements.  None 
4.5.28.623  Interrupts  and  signals.  None 
4.5.28.62.4  Algorithms.  None 
4.528.6.25  Error  handling.  None 
4.528.62.6  Data  conversion.  None 

4.528.6.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  SysMainLogoutCB  CSU: 

None 
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4.5^.6^8  Lofic  flow.  Single  pass. 
4.5.28.6.2.9  Data  structures.  None 


4.5.28.6.2.10 


i.  None 


4.5.28.6.2.11  Limitations.  N(me 


4.S.28.7  CSU  PutupSysMain 


4.5.28.7.1  CSU  PutupSysMain  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

45.28.7.2  CSU  PutupSysMain  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
PutupSysMain  CSU. 

4.5.28.7.2.1  Input/outPut  data  elements. 


INPUTS: 

"w"  contains  widget  id  of  button  pressed 
"client"  contains  client  data 

"call"  contains  X  Windows  data  about  the  call  reason 
OUTPUTS:  None 


4.52B.72.2 


None 


4.5JB.723 


h  None 


4.5.28.7.2.4  Algorithms.  None 


4.5.28.7.2.5 


None 


4.5.28.7.2.6 


None 


4.528.7.2.7  Use  of  other  elements.  Other  elements  1 
the  PutupSysMain  CSU: 

"sysMainTmi"  •  widget  id  of  TMI  area  of  sysMain  form 


Other  elements  that  are  used  by 
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"sysMainForm"  -  widget  id  of  entry  area  of  sysMain  form 
"tmiScreen"  -  widget  id  of  current  TMI 
"smdScreen"  -  widget  id  of  current  entery  screen 

4.5.28.7.2.8  Logic  flow.  Single  pass. 

4.5.28.7.2.9  Data  structures.  None 

4.5.28.7.2.10  Local  data  files  or  database.  None 

4.5.28.7.2.11  Limitations.  None 

4.5.29  Sub-Level  CSC  utiL 

The  following  paragraphs  tmder  this  section  describe  the  relationship  of  the 
util  Sub-Level  CSC  in  terms  of  data  flow  between  the  CSU's  of  this  Sub-level 
CSC. 

4.5.29.1  CSU  init.seleciions 

The  init_selections  CSU  imtializes  selection  menus. 

4.5Jt9.1.1  CSU  init.selections  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-inte^ace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.29.1.2  CSU  init.selections  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
init.selections  CSU. 

4.5.29.1.2.1  Input/output  data  elements. 

INPUTS:  None 

OUTPUTS:  None 

4.5.29.1.2.2  Local  data  elements.  None 
4.5.29.1.23  Interrupts  and  signals.  None 
4.539.13.4  Algorithms.  None 
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4.5^.1.2.5  Frmr  handling.  None 
4.5^.1^.6  Data  conversion.  None 

4.529.1.2.7  Use  of  other  elementa.  Other  elements  that  are  used  by 
the  init.selections  CSU: 

4.529.1.2.8  Logic  flow.  Single  pass. 

4.5.29.1.2.9  Data  structures.  None 
4.5.29.12.10  Local  data  files  or  database.  None 
4.529.12.11  LimitaHons.  None 


4.5292  CSU  route 

The  rotate  CSU  handles  the  roUticms  for  all  of  the  selection  menus. 

4.5292.1  CSU  route  requirements. 

This  CSU  satisfies  internally  derived  contractor  requiremenU  to  deuil  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man^machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digiul  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4J2922  CSU  route  design. 

The  information  identified  below  represents  the  detailed  design  of  the  route 
CSU. 


4.529.22.1  Input/output  data  elemenU. 

INPUTS: 

"^paner  -  panel  menu  to  be  acted  upon 
OUTPUTS:  None 

4.529.22.2  Local  daU  elements. 

"argent"  >  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  >  the  arguments  set  for  XtSetValues 

"argt^"  -  a  boolean  which  is  used  to  check  die  success  of  the  CONVERT 
call 

"xmstr"  •  local  to  hold  a  XmString 
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4.5^.2^.3  Interrupts  »nA  »iynaU.  None 
4.5^.2^.4  Algorithms.  Ntme 
4.5.29.2.2.5  Error  handling.  None 
4.5.29.22.6  Data  conversion.  None 

4.529.22.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  rotate  CSU: 

4.529.22.8  Logic  flow.  Single  pass. 

4.529.22.9  Data  structures.  None 

4.529.22.10  Local  data  files  or  database.  None 

4.529.22.11  Limitations.  None 


43293  CSU  moreAddress 

The  moreAddress  CSU  handles  the  more  button  calls  for  the  address  selection 
menus  from  all  the  reports. 

43293.1  CSU  moreAddress  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  eqmpment  package. 

432932  CSU  moreAddress  desigiu 

The  information  identified  below  represents  the  detailed  design  of  the 
moreAddress  CSU. 

4.52932.1  Input/output  data  elements. 


INPUTS; 

'^panel"  •  panel  menu  to  be  acted  upon 
OUTPUTS:  None 
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4.5.29.3.2.2  Local  data  elaments. 

"argent"  >  keeps  track  of  the  number  arguments  set  for  XtSetValues 
"args"  >  the  argtunents  set  for  XtSetValues 

"argdc"  -  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  -  local  to  hold  a  XmString 

4.5.29.3.2.3  Interrupts  and  signals.  None 

4.5.29.3.2.4  Algorithms.  None 

4.5.29.3.2.5  Error  handling.  None 

4.5.29.3.2.6  Data  conversion.  None 

4.5.29.3^1.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  moreAddress  CSU: 

4.5.29.3.2.8  Logic  flow.  Single  pass. 

4.5.29.3.2.9  Data  structures.  None 

4.5.29.3.2.10  Local  data  files  or  database.  None 

4.5.29.3.2.11  Limitations-  None 


4.5.29.4  CSU  moreLctn 

The  moreLctn  CSU  handles  the  more  button  calls  for  die  location  selection 
menus  hrom  all  the  reports. 

4.5.29.4.1  CSU  moreLctn  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.5.29.4.2  CSU  moreLctn  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
moreLctn  CSU. 
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4.5^.4^.1  Input/ftutpiit  data  etenatiK 
INPUTS: 

"panel"  -  panel  menu  to  be  acted  upon 
OUTPUTS:  None 
4.5^.4^^  Loeal  data  gl«ngnta. 

"argent"  -  keeps  track  of  dw  number  of  arguments  set  for  XtSetValues 
"args"  '  the  arguments  set  for  XtSetValues 

"argdk"  -  a  boolean  which  is  used  to  check  the  success  of  die  CONVERT 
caU 

"xmstr"  ■  local  to  hold  a  XmStrii^ 

4.5^.4^.3  Intemipts  and  signals.  None 
4.5^.4^.4  Algorithms.  N<me 

4.5.29.4.2.5  Error  handling.  None 

4.5.29.4.2.6  Data  conversion.  None 

4.5.29.4.2.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  morelxtn  CSU: 

4.529.4.2.8  Logic  flow.  Single  pass. 

4.529.42.9  Data  structures.  None 

4.529.42.10  Local  data  files  or  database.  None 

4.529.42.11  Limitations.  None 


43293  CSU  stringZtttm 

The  strmg2utm  CSU  converts  string  versions  of  UTM  locations  into  the  UTM 
structure  type. 

43293.1  CSU  stiiiigZtttm  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digits  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 


Page  294 


Doctunent  ADST/WDL/TR-93-003036 


March  31, 1993 


4L5^9^  CSU  stringZutm  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
string2utm  CSU. 

4.5.29.5.2.1  Input/output  data  glemente. 

INPUTS: 

"string"  -  string  version  of  locatimi 
OUTPUTS: 

"UTM"  •  UTM  structure  ivith  die  location 

4.5.29.5.2.2  Local  data  elements. 

"length"  -  length  of  the  string 
"index"  >  counter 

"valid"  -  boolean;  is  this  a  valid  UTM 


4.5.29.5.2.3  Interrupts  and  signals.  None 
4.5.29.52.4  Algorithms.  None 


4.529.5.2.5  Error  handling.  Ncme 

4.529.52.6  Data  conversion.  None 

4.529.52.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  string2utm  CSU: 

4.529.52.8  Logic  flow.  Single  pass. 

4.529.52.9  Data  structures.  None 


4.529.52.10  Local  data  files  or  database.  None 

4.529.52.11  l  imitaHons.  None 


4529.6  CSU  UpdateEnvelope 

The  UpdateEnvelope  CSU  updates  both  envelope  icons  to  reflect  the  current 
number  of  messages  diat  are  unread. 

4329.6.1  CSU  UpdateEnvelope  requirements. 

The  UpdateEnvelope  CSU  satisfies  section  3.2. 1.2.2. 1.4  of  the  sf>ecific 
requirments  of  the  DMCC  system. 
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45,29.6.2  CSU  UpdateEnvclope  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
UpdateEnvelope  CSU. 

4.529.6.2.1  Input /output  data  elements. 

INPUTS:  None 

OUTPUTS:  None 

4.529.6.2.2  Local  data  dements- 

"argent"  -  keeps  track  of  the  number  of  arguments  set  for  XtSetValues 
"args"  -  the  arguments  set  for  XtSetValues 

"argok"  -  a  boolean  which  is  used  to  check  the  success  of  the  CONVERT 
call 

"xmstr"  -  local  to  hold  a  XmString 

4.5.29.62.3  Interrupts  and  signals.  None 

4.529.6.2.4  Algorithms.  None 
4.529.62.5  Error  handling.  None 
4.5.29.62.6  Data  conversion-  None 

4.529.62.7  Use  of  other  elements.  Other  elements  that  are  used  by 
the  UpdateEnvelope  CSU: 

"numMsgLabel"  -  widget  id  of  the  Msgs  screen  envelope 
"envLabel2"  >  widget  id  of  the  SysMain  screen  envelope 

4.529.6.2.8  Logic  flow.  Single  pass. 

4.5.29.6.2.9  Data  structures.  None 

4.529.62.10  Local  data  files  or  database.  None 

4.529.62.11  Umitations.  None 
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4^30  Sub-Level  CSC  Builder  Xcessory  Functimis. 

The  following  paragraphs  under  this  section  describe  the  relationship  of  the 
Builder  Xcessory  Functions  Sub-Level  CSC  in  terms  of  data  flow  between  the 
CSU's  of  this  Sub-level  CSC.  The  functions  contained  herein  are  generated  by 
the  tool  Builder  Xcessory  and  are  not  modified  by  the  user,  therefore  there  is 
no  information  on  the  design  of  the  code. 

4.5.30.1.  CSU  CreateAddrList 

The  CreateAddrList  CSU  creates  the  Address  List  entry  screen. 

4.5.30.2.  CSU  Createfonn  requirements. 

The  Createform  CSU  creates  the  toplevel  form  screen. 

4.5.303.  CSU  formTrim 

The  formTrim  CSU  creates  the  decoratioits  on  most  of  the  screens. 

4.5.30.4.  CSU  CreateFreeTxtForm 

The  CreateFreeTxtForm  CSU  creates  the  Free  Text  entry  screen. 

4.5.30.5.  CSU  CreateGrpListForm 

The  CreateGrpListForm  CSU  creates  the  CEOI/Group  List  entry  screen. 

4.5.30.6.  CSU  CreateLocListFonn 

The  CreateLocListFonn  CSU  creates  the  Location  List  entry  screen. 

4.5.30.7  CSU  CreateLogonFonn 

The  CreateLogoiiForm  CSU  creates  d\e  Logon  screen. 

4.5.303  CSU  CreatemovcmdTmi 

The  CreatemovcmdTmi  CSU  creates  the  TMI  portion  of  the  Movcmd  report 
generation  screen. 

43.30.9  CSU  CreatemovcmdForm 

The  CreatemovcmdForm  CSU  creates  the  entry  portion  of  the  Movcmd 
report  generation  screen. 

4330.10  CSU  CreateMsglFonn 

The  CreateMsglFonn  CSU  creates  the  Msglscreen. 
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4.5J0.11  CSU  CreateMsgReadFofin 

The  CreateMsgReadForm  CSU  creates  the  Message  Read  screen. 

4.630.12  CSU  CreatemtoTmi 

The  CreatemtoTmi  CSU  creates  die  TMI  portion  of  the  MTO  report 
generation  screen. 

43.30.13  CSU  CreatemtoFonn 

The  CreatemtoFonn  CSU  creates  the  entry  portion  of  the  MTO  rep)ort 
generation  screen. 

4.5.30.14  CSU  CreateReportForm 

The  CreateReportForm  CSU  creates  the  Reports  screen. 

4.5.30.15  CSU  CreatereqtTmi 

The  CreatereqtTmi  CSU  creates  the  TMI  portion  of  the  Request  rep>ort 
generation  screen. 

4.5.30.16  CSU  CieatereqtForm 

The  CreatereqtForm  CSU  creates  the  entry  portion  of  the  Request  report 
generation  screen. 

4.5.30.17  CSU  CreatereuseTmi 

The  CreatereuseTmi  CSU  creates  the  TMI  portion  of  the  Reuse  report 
generation  screea 

4.5.30.18  CSU  CreatereuseForm 

The  CreatereuseForm  CSU  creates  the  entry  portion  of  the  Reuse  report 
generation  screen. 

4330.19  CSU  CreateshotTmi 

The  CreateshotTmi  CSU  creates  the  TMI  portion  of  the  Shot  report 
generation  screen. 

43.3030  CSU  CreateshotForm 

The  CreateshotForm  CSU  creates  the  entry  portion  of  the  Shot  report 
generation  screen. 
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4,5.30,21  CSU  CrcatesplashTmi 

The  CreatesplashTmi  CSU  creates  the  TMl  portion  of  the  Splash  report 
generation  screen. 

4,5.30JL2  CSU  CreatcsplashForm 

The  CreatesplashForm  CSU  creates  the  entry  p<»tion  of  the  Splash  report 
generation  screen. 

4.5.30J3.  CSU  CreatespotTmi 

The  CreatespotTmi  CSU  creates  the  TMI  portion  of  the  Spot  report  generation 
screen. 

4,5.30^24  CSU  CreatespotFonn 

The  CreatespotFonn  CSU  creates  the  entry  portion  of  tite  Spot  report 
generation  screen. 

4,5.30,25  CSU  CreateSysMainForm 

The  CreateSysMainForm  CSU  creates  the  Sys  Main  screen. 

4.6  CSC  pdtt  decode 

The  following  paragraphs  imder  titiis  section  describe  the  relationship  of  the 
pdu  decode  CX  in  terms  of  data  flow  between  the  CSU's  of  this  CSC  and 
identifies  all  CSU  interfaces  that  are  external  to  dte  pdu  decode  CSC. 

CSC  pdu  decode  partially  satisfies  System  Segment  Specification  requirements 
3.2.1.2.13  and  3.2.12.2.1. 

The  following  diagram  depicts  the  structure  of  the  pdu.decode  CSC: 
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Figure  12  CSU  pdu.decode  Structure 

4.6.1  CSU  pdu.decode. 

The  pdu.decode  CSU  calls  the  appropriate  function  to  decode  the  input 
message.  The  following  paragraphs  provide  design  information  for  this  CSU. 

4.6.1.1  CSU  pdu.decode  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 
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4.6.1.2  CSU  pdu.decode  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
pdu_decode  CSU. 

output  s  pdu_decode  (ii^ut  message  pointer  of  DMCPDU.type) 

a.  Input/output  data  elements. 

INPUTS: 

"pdu"  is  a  DMCPDU.type  pointer  containing  the  input  message 
to  be  decoded. 

OUTPUTS: 

"dmc.buffer"  is  a  static  character  buffer  of  size  (18+15)x36 
containing  the  decoded  message  to  be  returned. 

b.  Local  data  elements. 

'*hdr_str'‘  is  a  character  pointer  to  a  buffer  that  contains  the 
message  header  information. 

"msg_str"  is  a  character  pointer  to  a  buffer  that  contains  the 
message  information. 

"header_common"  is  a  Non_specific  pointer  that  points  to  the 
common  header  structure. 

"subtype"  is  an  integer  storage  that  contains  the  pdu  subtype  id. 
"variation"  is  an  integer  storage  that  contains  the  pdu  variation 
id. 

"good.pxlu"  is  a  boolean  flag  of  integer  type, 
c  Interrupts  and  signals.  None 

d.  Algorithms. 

decode  and  appeiui  the  messa^  variation  type  to  ret.str  based  upon  its 
subt3rpe. 

decode  and  append  the  following  fields  to  ret_str  in  order: 

Based  upon  the  input  message  subtype  and 

variation  field,  invoke  pdu.spec.decodeQ  ax\d  one  of  the  following  : 

1.  decode_ack_pdu()  with  an  Ack.type  input  message  pointer. 

2.  decode_spot_pdu( )  with  a  Spot.type  input  message  pointer. 

3.  decode_bda_^u()  with  an  BDA_t)^  ii^ut  message  pointer 

4.  decode_free_text()  wiht  a  FreeText.type  input  message  pointer 

5.  decode_gndroute_pdu()  with  a  Recon.type  input  message  pointer 

6.  decode_airroute_pdu()  with  a  Recoiutype  input  message  pointer 

7.  decode_bridge_pdu()  with  a  Recon^ty^  input  message  pointer 

8.  decode_lzpz_pdu()  with  a  Recon_ty{^  input  message  pointer 
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9.  decode_bpop_pclu()  with  a  Recon_type  input  message  pointer 

10.  decode_crossing_pdu()  witii  a  Recon_type  input  message  pointer 

11.  decode_repeat_pdu()  %vith  an  Artillery_type  input  message  pointer 

12.  decode_canceLpdu()  with  an  Artillery_t)^  input  message  pointer 

13.  decode_check_^u()  with  an  Artillery_type  input  message  pointer 

14.  decode_cno_pdu()  with  an  Artiilery_typ€  input  message  pointer 

15.  decode_shift_pdu()  with  an  Artillery_type  input  message  pointer 

16.  decode_nwmsn_pdu()  an  Artillery_type  input  message  pointer 

17.  decode_mto_pdu()  with  an  Artillery_type  input  message  pointer 

18.  decode_shot_pdu()  with  an  Artillery_type  input  message  pointer 

19.  decode_splash_pdu()  with  an  Artillery^type  input  message  pointer 

20.  decode_eom_pdu()  with  an  Artillery_type  input  message  pointer 

e.  Error  handling.  Use  of  system  'printf  statement  to  output  error 
message  to  console  screen. 

f.  Data  conversion.  None 

g.  Use  of  Other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode_spot_label, 
arget_enum_str, 
activity_enum_str, 
direction_enum_str, 
obs_int.enum_str. 

Library  routines: 
switch  -  case, 
strcat. 

CSUs: 

pdu_spec_decode, 

decode_ack_pdu, 

decode_spot_pdu, 

d€code_bda_pdu, 

decode_free_text_pdu, 

decode_gndroute_pdu, 

decode_airroute_pdu, 

decode.bridge^pdu, 

decode_lzpz_pdu, 

decode_bpop_pdu, 

decode_crossing.pdu, 

decode_repeat_pdu, 

decode_cancel_pdu, 

decode_check_pdu, 

decode_cno_pdu, 

decode_shift_pdu. 
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decode_nwmsn.pdu, 

decode_mto«pdu, 

decode.shot_pdu, 

decode_spia8h_pdu, 

decode.eom.pdu, 

decode.status.pdu, 

decode_request_pdu, 

decode_nbcl_pdu, 

decode_nbc4.pdu, 

decode_nbc5_pdu, 

decode.miji.pdu, 

decode_pirep_pdu, 

decode_dnav_pdu, 

decode_movcmd_pdu. 

h.  Logicilow- 

map  header.common  template  to  Non.specific  input  message 
pointer; 

retrieve  subtype  and  variation  value  from  input 
message(header_common  template); 
set  good.pdu  to  true; 

Switch  on  input  message  subtye 
case  Acknowlegement  invoke 
pdu_spec_decode; 
decode_ack.pdu; 
case  Spot  invoke 
pdu_spec_decode; 
decode_spot_pdu; 

case  Battle  Damage  Assessment  invoke 
pdu_spec_decode; 
decode_bda_pdu; 
case  Free  Text  invoke 
pdu_spec_decode; 
decode_free-text_pdu; 
case  Reconaissance  invoke 
switch  on  message  variation 
case  ground  route  reconaissance  report  invoke 
pdu_spec_decode; 
decode_gndroute_pdu; 
case  air  route  reconaissance  report  invoke 
pdu_spec_decode; 
decode_airroute_pdu; 
case  bridge  reconaissance  report  invoke 
pdu_spec_decode; 
decode.bridge_pdu; 
case  landing  zone/pickup  zone  invoke 
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pdu.spec_decode; 
decode.lzpz_pdu; 
case  BP/OP  invoke 
pdu.spec_decode; 
decode_bpop4)du; 
case  crossing  invoke 
pdu^spec.decode; 
decode.crossing.4)du; 
case  Artillery  invoke 

switch  on  header.common>>Common. Variation 
case  repeat  invoke 
pdu.spec_decode; 
decode_repeat4>du; 
case  cancel  invoke 
pdu.spec_decode; 
decode.cancel.pdu; 
case  check  invoke 
pdu.spec.decode; 
decode.check.pdu; 
case  cno  invoke 
Ixiu.spec.decode; 
decode.cno.pdu; 
case  shift  invoke 
pdu.spec.decode; 
decode.shift_pdu; 
case  new  mission  invoke 
pdu.spec.decode; 
decode^wmsn.pdu; 
case  message  to  observer  invoke 
pdu.spec.decode; 
decode.mto.4>du; 
case  shot  invoke 
pdu^spec.decode; 
decode.shot4xlu; 
case  splash  invoke 
pdu.spec.decode; 
decode.splash.pdu; 
case  end  of  mission  invoke 
pdu.spec.decode; 
decode.eom.pdu; 
case  status  invoke 
pdu.spec.deGode; 
decode.status.pdu; 
case  request  invoke 
pdu.spec.decode; 
decode.request.pdu; 
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case  Nuclear,  Biological,  Chemical  invoke 
switch  on  variation 

case  Nuclear,  Biological,  Chemical  Type  1  invoke 
pdu.spec_decode; 
decode.nbcl_pdu; 

case  Nuclear,  Biological,  Chemical  Type  4  invoke 
pdu_spec_deoode; 
decode.nbc4.pdu; 

case  Nuclear,  Biological,  Chemical  Type  5  invoke 
pdu.spec.decode; 
decode.nbc5.pdu; 

case  Meaconing,  Intrusion,  Jamming,  Interface 
pdu.spec.decode; 
decode.iniji.4>du; 
case  Pilot  Report  invoke 
pdi;L.spec.decode; 
decode.pirep.pdu; 
case  Down  Air  Vehicle  invoke 
pdu.spec.decode; 
decode.dnav.pdu; 
case  Move  Comand  invoke 
pdiL.spec.decode; 
decode.movcmd.pdu; 
return  pdu.spec.decode  to  hdr.str; 
retunr  decode  message  to  msg.str; 
display  error  message  for  invalid  subtype; 

append  the  decoded  message  hdr.str  and  msg.str  strings  to 
dmc.buffer; 

return  dmc.buffer  to  caller; 

i.  Data  structures.  None. 

j.  Local  data  files  or  database.  None 

k.  Limitarions.  None 


4.6,2  CSU  pda.spec.decodc 

The  pdu.spec.decode  CSU  decodes  the  irq>ut  message's  header  informatioa 
The  foUowing  paragraphs  provide  design  information  fcv  this  CSU. 
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4.6^1  CSU  pdu.spec.decode  requirements. 

This  CSU  satisHes  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

AAJ12  CSU  pdu_spec_decode  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
pdu_spec_decode  CSU. 

output  s  pdu_spec_decode(  input  message) 

a.  Input /output  data  elements. 

INPUTS: 

"pdu"  is  a  DMCPDU.type  pointer  containing  the  input  message 
to  be  decoded. 

OUTPUTS: 

"ret^str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  eigments. 

"str_ptr"  is  a  static  character  pointer  that  points  to  a  temporary 
decoded  UTM  message. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"header.common"  is  a  Non.spedfic  pointer  that  points  to  the 
common  header  structure. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

"subtype"  is  an  integer  storage  that  contains  the  pdu  subtype  id. 
"variation"  is  an  integer  storage  that  contains  ^e  pdu  variation 
id. 

c  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret_str. 

decode  and  append  the  message  variation  type  to  ret.str  based  upon  its 
subtype. 

decode  and  append  the  following  fields  to  ret.str  in  order: 
message  priority. 
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message  sender  CK)I, 
message  receiver, 
message  Inward  by, 
message  sent  time/date, 
message  transmit  locatinv 
message  transmit  altitude  in  leet 

*  append  a  carriage  return  to  retjttr  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  eonvgraion.  None 

g.  Use  of  other  dmumta. 

The  following  provide  the  string  values  of  "Enumerated"  types 
character  pointer: 

decode.recon.variation,  decode.artillery.variation, 

decode.nbc.variation, 

decode.subtype, 

decode.headerjabel. 

Library  routines: 

sprintf, 

streat, 

stmeat 

eSUs: 

sprintf_UTM, 

decode.time. 

h.  Logic, ilfliaE. 

set  header.common  tenqplate  to  Non_specific  *  pdu; 
retrieve  message  subtype  and  variation  value  from  input  message; 
place  a  null  in  the  first  byte  of  retjstr; 
s%vitch  on  subtype 
case  Reconaissance  pdu 
append  its  variation  to  ret.str; 
case  Artillery  pdu 
append  its  variation  to  ret.str; 
case  Nuclear,  Kological,  Chemical  type  pdu 
append  its  variat^  to  ret_str; 
ofitm,  invoke  decode_subtype(subtype]  to  ttte 
return  buffer  ret_str; 

if  message  Priority  is  true 
appeitd  "urgency"  to  ret_str; 
else  append  "routine"  to  ret_str; 
append  a  carriage  return  to  retjstr; 
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append  the  Sender  CEOI  title,  the  Sender  CEOI  string,  and  a  carriage 
return  to  ret_str; 

app)end  the  Target  CEOI  title,  the  Target  CEOI  string,  and  a  carriage 
return  to  ret.str; 

append  the  Last  Forward  CEOI  tide,  the  Last  Foward  CEOI  string,  aiul  a 
carriage  return  to  ret.str; 

invoke  decode_time()  to  decode  the  Send  time; 

append  the  Send  dme  title,  the  decoded  Send  time,  and  a  carriage 
return  to  ret_str; 

invoke  sprintf_UTM()  to  decode  the  transmit  location; 

append  the  [transmit  location  title,  the  sprintf.UTM  result,  and  a 
carraige  return  to  ret.str. 

convert  Altitude  into  a  string  with  "feet"  as  the  unit; 

append  the  Altitude  title,  the  converted  Altitude  string,  and  a  carriage 
return  to  ret_str; 

retiiim  ret.str  to  caller. 

i.  Data  structures-  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.3  CSU  decode_ack_pda 

The  decode_ack_pdu  CSU  decodes  the  Acknowledgement  ii^ut  message. 

The  following  paragraphs  provide  design  mformation  fw  this  CSU. 

4.63.1  CSU  decode_ack_pda  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.6.33  CSU  decode.ack_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_ack_pdu  CSU. 
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Syntax  invoking  this  function: 
output  >  decode_ack4xlu(  pdu); 

a.  Input/output  data  elamanta. 

INPUTS: 

"pdu"  is  a  Ack.type  pester  containing  the  ix^ut  message  to  be 
decoded. 


OUTPUTS: 

"ret_str"  is  a  static  character  buffer  of  sizel8x36  containing  the 
decoded  message  string  to  be  returned. 


b. 


Local  data  elei 


"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoct  message. 


c  Interrupts  and  signals.  None 


d.  Algorithms, 
store  a  null  in  the  first  byte  of  ret_str. 
append  a  carriage  return  to  ret.str. 
decode  and  appn^  the  following  fields  to  ret.str  in  order: 
Acknowledge  CEOI; 

Original  DTG; 

Free  Text  Anxu>tation  Striz^. 


*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 


e.  Error  handling.  None 

f.  Data  conYfirsion-  None 

g.  Use  of  Qthg  filgnmts. 

The  following  provide  the  string  values  of  "Enumerated”  types 
constant  char 

decode.ack.label  >  two  dimensioital  array  of 
size  15x16, 

Library  routines: 

sprintf, 

streat, 

stmeat. 

eSUs: 

decode.time. 
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h.  Logic  flow, 
set  ret_str  to  null; 

append  a  carriage  return  to  ret.str; 

append  the  Admowledge  CEOI  title,  the  Acknowledge  CEOI  string,  and 
a  carriage  return  to  ret_str; 

invoke  decode.time  to  decode  the  Original  DTG; 
append  the  Origiiuil  DTG  title,  the  decode  Origixud  DTG  string,  and  a 
carriage  return  to  ret.str; 

append  nine  carriage  returns  to  ret.str(  nine  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret^str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret_str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.4  CSU  decode_spot.pdu 

The  decode_spot_pdu  CSU  decodes  the  Spot  input  message.  The  following 
paragraphs  provide  design  information  for  this  CSU. 

4.6.4.1  CSU  decode_spot.pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.6.4.2  CSU  decode_spot_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode.spot^du  CSU. 

Syntax  for  invoking  this  function: 
output  s;  decode_spot.4>du(  pdu); 
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a.  Input/output  data  elements. 

INPUTS: 

”  pdu"  is  a  Spot_type  pointer  containix^  the  input  message  to  be 
decoded. 

OUTPUTS: 

"ret.str”  is  a  character  butfer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"str^ptr”  is  a  static  character  pointer  that  points  to  the  temporary 
decoded  UTM  message. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

c.  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret.str. 

append  a  carriage  return  to  ret.str. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Target  (^antitiy. 

Target  Type, 

Target  Activity  Type, 

Target  Speed, 

Target  Unit, 

Target  Location, 

Target  Sighted  Time, 

Observer  Location, 

Observer  Intention, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret.str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  > 
character  pointer: 
decode_spot_label, 
arget.enum.str. 
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activity_enum_str, 
direction_enum_str, 
obs_int.enum_str. 
library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether, 

sprintf.speed, 

sprintf.UTM, 

decode.time. 

h.  Logic  flow. 

set  ret.str  to  null; 

append  a  carriage  return  to  ret_str; 

convert  Target  Quantity  into  a  string; 

append  the  Target  Quantity  title  and  the  Target  Quantity  string  to 
ret.str  with  a  carriage  return  at  the  end; 

if  TargetType  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
niuxito  of  possible  Target  Type, 
decode  Target  Type; 
else 

decode  Target  Type  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Target  Type  title,  the  decoded 
Target  T)rpe  string  id  a  carriage  return  to  ret_str; 

if  Target  Activity  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
number  of  possible  Target  Activity  Type, 
decode  Target  Activity; 
else 

decode  Target  Type  with  an  invalid.entry  string; 
invoke  puttogetherQ  to  append  the  Target  Activity  title,  the  decoded 
Target  Activity  string  and  a  carriage  return  to  ret_str; 

invoke  sprintf.speed()  to  decode  die  Target  Speed; 
append  the  Target  Speed  title,  the  decoded  Target  Speed  string  and  a 
carriage  return  to  ret_str; 

if  Target  Direction  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
number  of  pos^le  Target  Direction, 
decode  Target  Direction; 
else 

decode  Target  Direction  with  an  invalid.entry  string; 
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invoke  puttogether()  to  append  the  Target  Direction  title,  the  decoded 
Target  Direction  string  and  a  carriage  return  to  ret.str; 

append  the  Target  Urut  title,  the  decode  Target  Unit  and  a  carriage 
return  to  ret_str; 

invoke  sprintf_UTM()  to  decode  Target  Location; 
append  the  Target  Location  title,  the  decoded  Target  Location  string  and 
a  carriage  return  to  ret.str; 

invoke  decode_time()  to  decode  Time  Sighted; 

append  the  Target  Time  Sighted  title,  the  decoded  Time  Sighted  string 
and  a  carriage  return  to  ret.str; 

invoke  sprintf_UTM()  to  decode  Observer  Location; 
append  the  Observer  Location  title,  the  decoded  Observer  Location 
string  and  a  carriage  return  to  ret.str; 

if  Observer  Intention  is  greater  than  or  equal  to  zero  and  it  is  less  than 
the  number  of  possible  Observer  Intentions, 
decode  Observer  Intention; 
else 

decode  Observer  Intention  with  an  invaUd.entry  string; 
invoke  puttogether()  to  append  the  Observer  Intention  title,  the 
decoded  Observer  Intention  string  and  a  carriage  return  to 
ret.str; 

append  a  carriage  rehm  for  a  blank  line; 

append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 

append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 

return  ret_str. 

i.  Data  structures.  None 

j.  Local  data  fUes  or  database.  None 

k.  Limitations-  None 


4.6.5  CSU  decode_bda_pdu 

The  decodeJ>da_pdu  CSU  decodes  d\e  Batde  Damage  Assessment  input 
message.  The  following  paragraphs  provide  design  information  for  diis  CSU. 
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4.6.5.1  CSU  decode_bda_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.5.2  CSU  decode_bda_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_bda_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  =  decode_bda_pdu(  pdu); 

a.  Input /output  data  elements. 

INPUTS: 

"  pdu"  is  a  Battle  Damage  Assessment  (BDA_type)  type  pointer 
containing  the  input  message  to  be  decoded. 

OUTPUTS: 

"ret_str"  is  a  static  character  buffer  of  si2el8x36  containing  the 
decoded  message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  tempo’  y  decoded  message. 

"temp"  is  a  tempos  -  storage  that  contains  the  integer  value  of 
a  message  field. 

c.  Interrupts  and  signals.  None 

d  Algorithms. 

store  a  nij^  in  the  first  byte  of  ret.str. 

append  a  carriage  return  to  ret.str. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Strike  Start  Time, 

Strike  End  Time, 

Target  Category, 

Target  Type, 

#  of  Target  Destroyed, 

#  of  Percent  Coverage, 

Free  Text  Aimotation  String. 
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^append  a  carriage  return  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  • 
character  pointer: 
decode_b^_str, 
target_enum_str, 
percent_cover_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether, 

decode.time. 

h.  Logic  flow. 

set  ret_str  to  null; 

append  a  carriage  return  to  ret^str; 

invoke  decode_time()  to  decode  the  start  of  Strike  Time; 

append  the  Strike  Time  Start  title,  the  decode  time  and  a  crriage  return 
to  ret_str; 

invoke  decode_time()  to  decode  the  end  of  Strike  Time; 

append  the  Strike  Time  End  title,  the  decode  time  and  a  crriage  return 
to  ret_str; 

append  the  Target  Category  title  and  a  carriage  retium  to  ret.str. 

if  TargetT3rpe  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
mm^r  of  possible  Target  Type, 
decode  Target  Type; 

else 

decode  Target  Type  with  an  invalid.entry  string; 

invoke  puttogether()  to  app>end  the  Target  Type  title,  the  decoded 
Target  Type  string  and  a  carriage  return  to  ret.str; 

convert  the  Target  Destroyed  into  a  string; 

append  the  Target  Destroyed  title,  the  Target  Destroyed  string  and  a 
carriage  reture  to  ret.str; 
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if  Percent  Coverage  type  is  greater  than  or  equal  to  zero  and  it  is  less 
than  the  number  of  possible  Percent  Coverage  type, 
decode  Percent  Coverage  type; 
else 

decode  Percent  Coverate  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Percent  Coverage  title,  the  decoded 
Percent  Coverage  string  and  a  carriage  return  to  ret.str; 

append  hve  carriage  return  to  ret.str(for  five  blank  lines); 
append  the  hrst  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  aiul  a  carriage  to  ret.str; 
return  ret_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitarions.  None 


4,6.6  CSU  decode_free.text_pdu 

The  decode_free_text_pdu  CSU  decodes  the  Free  Text  input  message.  The 
following  paragraphs  provide  design  information  for  tills  CSU. 

4.6.6.1  CSU  decode_free_text_pdu  requirements. 

This  CSU  satisfies  internaUy  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.6.2  CSU  decode_free_text_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the  ■ 
decode_fi:ee_text_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  =  decode_£ree_text_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"  pdu"  is  a  Free  Text  (FreeText_type)  type  pointer  containing  the 
input  message  to  be  decoded. 
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OUTPUTS: 

"ret.str"  is  a  static  character  buffer  of  sizel8x36  containing  the 
decoded  message  string  to  be  returned. 


d.  Algorithms. 

store  a  null  in  the  ffrst  byte  of  ret_str. 

decode  and  append  the  Free  Text  string  to  ret_str; 


Data  elements:  None 
Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs:  None 

h.  Logic  flow, 
set  ret_str  to  null; 

append  the  Free  Text  string  and  a  carriage  return  to  ret_str; 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret_str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret_str; 
return  ret.str  to  caller. 


i. 

j- 

k. 


4.6.7  CSU  decode_gndroute_pdu 

The  decode_giuiroute_pdu  CSU  decodes  the  Grotmd  Route  input  message. 
The  following  paragraphs  provide  design  information  for  this  CSU. 
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4.6.7.1  CSU  decode_gndroute_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.6.7.2  CSU  decode_gndroute.pdu  design. 

The  ii\formation  identified  below  represents  the  detailed  design  of  the 
decode_gndroute_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  =  decode_bda_pdu(  pdu); 

a.  Input /output  data  elements. 

INPUTS: 

"  pdu"  is  a  ground  route  reconaissance(Recon  _type)  type 
pointer  containing  the  input  message  to  be  decoded. 

OUTPUTS: 

"ret_str"  is  a  static  character  buffer  of  sizel8x36  containing  the 
decoded  message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

"temp.char"  is  a  temporary  unsigned  character  storage. 

c  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret_str. 

append  a  carriage  return  to  ret^str. 

decode  and  append  the  following  helds  to  ret.str  in  order: 

Enemy  Activity, 

Clssification  Formula, 

Classification  Formula  Information, 

Route  ID, 

Free  Text  Aimotation  String. 

^append  a  carriage  return  at  the  end  of  each  field. 
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e.  Ermr  handling  None 

f.  Data  conversion.  None 

g.  Use  of  othfiT  gtemmta- 

The  following  provide  the  string  values  of  ‘‘Enumerated"  types  - 
character  pointer: 
decode_gndroute, 
classif_enum_str, 
activity_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether(). 

h.  Logic  flow, 
set  ret_str  to  null; 

append  a  carriage  return  to  ret^tr; 

if  Enemy  Activity  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
number  of  pos^le  Enemy  Activity  Type, 
decode  Enemy  Activity  Type; 
else 

decode  Enemy  Activity  Tjrpe  with  an  invalid.entry  string; 
invoke  puttogetherQ  to  appe^  the  Enemy  Activity  title,  the  decoded 
Enemy  Activity  Type  string  and  a  carriage  return  to  ret_str; 

if  Qassification  Formula  is  greater  than  or  eqtud  to  zero  and  it  is  less 
than  the  number  of  possible  Classification  Formula  Type, 
decode  Classification  Formula  Type; 
else 

decode  Classification  Formula  Type  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  t^  Qassification  Formula  title,  the 
decoded  Qas^cation  Formula  Type  string  and  a  carriage  return 
to  ret_str; 

append  the  Qassification  Information  title,  the  Classification  Formular 
Information  string,  and  a  carriage  return  to  ret.str; 

append  the  Route  ID  tide,  die  Route  ID  string,  and  a  carraige  return  to 
ret_str; 

append  seven  carriage  return  to  ret_str(seven  blank  lines); 
concatenate  the  first  line(32  characters)  of  die 
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pdu->Cominon.FreeText  and  a  carriage  into  ret.str; 
concatenate  the  next  line(32  characters)  of  the 
pdu->Common.FreeText  32  and  a  carriage  into  ret_str; 

return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  nr  database.  None 

k.  LimitaHons.  None 

4.6.8  CSU  decode_airroute_pdtt 

The  decode_airroute_pdu  CSU  decodes  the  Air  Route  input  message.  The 
following  paragraphs  provide  design  information  for  this  CSU. 

46.8.1  CSU  decode_airroute_pda  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commuiucations  System  compliant 
with  customer  directives  to  provide  a  man>machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

46.8.2  CSU  decode_airroute_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode.airroute.pdu  CSU. 

Syntax  for  invoking  this  function: 
output  »  decode_airroute.pdu(  pdu); 

a.  Input/outpur  data  glgments. 

INPUTS: 

"pdu"  is  a  airroute.type  pointer  containing  the  input  message  to 
be  decoded. 

OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 
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“temp"  is  a  teii^xjrary  sttvage  that  contains  ttie  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 

d.  Aigoiithma- 

place  a  null  in  the  first  byte  of  ret.str. 

append  a  carriage  return  to  ret.str. 

decode  and  append  d%e  flowing  fields  to  retLStr  in  order: 

Enemy  Activity, 

Obstacles, 

Route.ID, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret_str  at  the  end  of  each  fidd. 

e.  Error  handUng.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  “Enumerated"  types  - 
character  pointer: 
decode.airroute, 
activity.enum.str, 
obstacle.enum.str. 

Library  routines: 

sprintf, 

street, 

stmeat. 

eSUs: 

puttogether. 

h.  Lppc-flow. 

set  ret.str  to  null; 

append  a  carriage  return  to  ret_str(one  blank  line); 

if  Enemy  Activity  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
number  of  posl^le  Enemy  Activity  Type, 
decode  Enemy  Activity  Type; 
else 

decode  Enemy  Activity  Type  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Enemy  Activity  title,  the  decoded 
l^my  Activity  Type  string  and  a  carriage  return  to  ret.str; 
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if  Obstacles  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
number  of  possible  Obstacle  Type, 
decode  Obstacle  Type; 
else 

decode  Obstacle  Type  widi  an  invalid.entry  strixtg; 
invoke  puttogether()  to  append  the  Obstacle  title,  the  decoded  Obstacle 
Type  string  a^  a  carriage  return  to  ret.str; 

append  the  Route  ID  tide,  the  Route  ID  string  to  ret.str,  and  a  carriage 
return  to  ret^str; 

append  six  carriage  retun  to  ret.str(  for  six  blank  lines); 
append  the  drst  32  Free  Text  characters  and  a  carriage  to  ret_str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  retjstr; 
return  ret_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.9  CSU  decode_bridge_4pda 

The  decode_bridge_pdu  CSXJ  decodes  the  Bridge  Reconaissance  iiq>ut 
message.  The  following  paragraphs  provide  design  information  far  dus  CSU. 

4.6.9.1  CSU  decode_bridge_pdtt  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.9.2  CSU  decode.bridge^du  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode.bridge.pdu  CSU. 

Syntax  for  invoking  this  function: 
output »  decode.bridge.4)du(  pdu); 

a.  Input/output  data  elements. 
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INPUTS: 

"pdu"  is  a  Recon_type  pointer  containing  the  input  message  to 
decoded. 

OUTPUTS: 

’’ret.str"  is  a  character  butfer  of  sizel8x36  containing  die  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buHer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  die  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret_str. 

decode  and  append  die  following  fields  to  ret.str  in  order: 

Bridge  T)rpe, 

Damage, 

Spans, 

Construction  Material, 

Bridge  Length, 

Bridge  Width, 

Bridge  Height, 

Bridge  Under, 

Bridge  Construction  Descriptitm, 

Bridge  ID, 

Bridge  Span  Length, 

Bridge  Load  Qass, 

Free  Text  Aimotation  String. 

*  append  a  carriage  return  to  ret.str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Eniunerated"  types  • 
character  pxnnter: 
decode.bridge, 
bridge.enum.str, 
bridge.damage_enum_str, 
bridge.material.enum.str. 
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Library  routines: 

sprintf, 

street, 

stmeat. 

eSUs: 

puttogether. 

h.  Logic  floiae- 

set  ret_str  to  null; 

if  Bridge  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
num^  of  possible  Bridge  Type. 

decode  Bridge  Type; 
else 

decode  Bridge  Type  with  an  invalid_entry  string; 
invoke  puttogedierQ  to  append  the  "BRIDGE  TYPE"  title,  the  decoded 
Bridge  Type  string  and  a  carriage  return  to  ret_str; 

if  Bridge  Damage  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than 
the  numto  of  possible  Bridge  Damage  Type. 

decode  Bridge  Damage  Type; 
else 

decode  Bridge  Damage  Type  widi  an  invalidLentry  string; 
invoke  puttogether()  to  append  the  Damage  title,  the  decoded  Bridge 
Damage  Type  string  and  a  carriage  return  to  retjstr; 

convert  the  Bridge  Spans  into  a  string; 

append  die  Spans  tide,  the  Bridge  Spans  string,  and  a  carriage  return  to 
ret_str; 

if  Bridge  Construction  Material  Type  is  greater  than  or  equal  to  zero 
and  it  is  less  than  the  number  of  possible  Bridge  Construction 
Material  Type. 

decode  Bridge  Construction  Material  Type; 
else 

decode  Bridge  Construction  Material  Type  with  an  invalid.entry 
string; 

invoke  puttogether()  to  append  the  Construction  Material  title,  the 
decoded  Bridge  Construction  Material  Type  string  and  a  carriage 
return  to  ret_str; 

append  the  Length  tide,  the  Bridge  Length  string,  and  a  carriage  return 
into  ret_str; 

append  the  Width  tide,  the  Bridge  Width  string  and  a  carriage  return 
into  ret_str; 
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append  the  Height  title,  the  Bridge  Height  string  aiui  a  carriage  return 
into  ret^str; 

append  the  Under  title,  the  Bridge  Under  string  and  a  carriage  return 
into  ret_str; 

append  the  Construction  Description  title,  the  Bridge  Construction 
[Description  string  and  a  carriage  return  into  ret_str; 

append  the  Bridge  ID  title,  the  Bridge  ID  string  and  a  carriage  return 
into  ret_str; 

append  the  Span  Length  title,  the  Bridge  Span  Length  string  and  a 
carriage  return  into  ret.str; 

append  the  Load  Class  title,  the  Bridge  Load  Class  string  and  a  carriage 
return  into  ret.str; 

append  the  first  32  Free  Text  characters  and  a  carriage  to  ret_str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j-  Local  data  files  or  database.  None 

k.  Limitarions.  None 


4.6.10  CSU  decode_lzpz_pdu 

The  decode.lzpz.pdu  CSU  decodes  the  Landing/Pickup  Zone  Reconaissance 
input  message.  The  followmg  paragraphs  provide  design  information  for 
this  CSU. 

4.6.10.1  CSU  decodc_lzpz_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
sxibfunction  of  a  helicopter  mission  equipment  package. 

4.6.10.2  CSU  decodejzpz^dtt  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode.lzpz_pdu  CSU. 
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Syntax  for  invoking  this  function: 
output  s  decode_lzpz_pdu(  pdu); 

a.  Input/output  data  glgments. 

INPUTS: 

"  pdu"  is  a  Recon_type  pointer  containing  the  input  message  to 
be  decoded. 

OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  die  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  m^sage. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret.str. 

append  a  carriage  return  to  ret^str. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Activity  Likely  Type, 

Obstacles  T)rpe, 

Obstacles  Description, 

Landing/Pickup  Zone  ID, 

Landing/Pickup  Zone  Sm, 

Free  Text  Annotation  String. 


*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 


& 


Us€ 


The  following  provide  the  string  values  of  "Enumerated"  types 
character  pointer: 
decode_lzpz, 
activity_enum_str, 
obstacle_enum_str. 

Library  routines: 
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sprintf, 

street, 

stmeat. 

eSUs: 

puttogether. 

h.  Logic  flow, 
set  ret_str  to  null; 

append  a  carriage  return  to  ret_str(a  blank  line); 

if  Activity  Likely  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than 
the  numl^  of  possible  Activity  Likely  Type, 
decode  Activity  Litely  Type; 
else 

decode  Activity  Likely  Type  with  an  invalid_entry  string; 
invoke  puttogetherQ  to  append  the  Activity  Likely  title,  the  decoded 
Activity  Likely  Type  string  and  a  carriage  return  to  ret_str; 

if  Obstacle  is  greater  than  or  equal  to  zero  and  is  less  than  the  number 
of  possible  ObstacleType. 
convert  Obstacle  into  a  string; 
else 

decode  Obstacle  Type  with  an  invalid.entry  string; 
invoke  puttogetherQ  to  append  the  Obstacles  title,  the  decoded  Obstacle 
Type  string  and  a  carria^  mtum  to  ret_str; 

append  the  Obstacle  Description  title,  the  Obstacle  Description  string, 
and  a  carriage  return  to  ret.str; 

append  the  LZ/PZ  ID  title,  the  Loading/Pickup  Zone  ID  string,  and  a 
carriage  return  to  ret_str; 

append  the  LZ/PZ  Size  title,  the  Loadmg/Pickup  Zone  Size  string,  and- 
a  carriage  return  to  ret_str; 

append  six  carriage  returns  to  ret.str(  six  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret_str; 
append  the  next  32  Free  Text  characters)  aiul  a  carriage  to  ret.str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 
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4.6.11  CSU  decode_bpop_pdu 

The  decode_bpop_pdu  CSU  decodes  the  bpop  Reconaissance  input  message. 
The  following  paragraphs  provide  design  information  for  this  CSU. 

4.6.11.1  CSU  decode_bpop_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commurucations  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.6.11.2  CSU  decode_bpop_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_bpop_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  =  decode_bpop_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"  pdu”  is  a  Recon_type  pointer  containing  the  input  message  to 
be  decoded. 

OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str”  is  a  static  uitsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temp>orary  storage  that  contains  the  integer  value  of 
a  message  field. 

c  Interrupts  and  signals-  None 

d.  Algorithms- 

store  a  null  in  the  first  byte  of  ret_str. 

append  a  carriage  return  to  ret.str. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Enemy  Activity  Type, 

Obstacles  Type, 

Obstacles  E^scription, 

BP/OP  ID, 
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BP/OP  Size, 

BP/OP  Axis, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode.bpop, 
activity  _enum_str, 
obstacle_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  LogicflQW- 
set  ret_str  to  null; 

apf>end  a  carriage  return  to  ret_str(a  blank  line); 

if  Enemy  Activity  Type  is  greater  than  or  equal  to  zero  and  it  is  less 
than  the  numter  of  possible  Enemy  Activity  Type, 
decode  Enemy  Activity  Type; 
else 

decode  Enemy  Activity  Type  with  an  invalid.entry  string; 
invoke  puttogetherQ  to  appoid  the  Activity  Likely  title,  the  decoded 
Enemy  Activity  Type  string  and  a  carriage  return  to  ret_str; 

if  Obstacle  is  greater  than  or  equal  to  zero  and  is  less  than  the  number 
of  possible  ObstacleType. 
convert  Obstacle  into  a  string; 
else 

decode  Obstacle  Type  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Obstacle  title,  the  decoded  Obstacle 
Type  string  a^  a  carriage  return  to  ret.str; 

append  the  Obstacle  Description  title,  the  Obstacle  Description  string, 
and  a  carriage  return  to  ret_str; 
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append  the  BP/OP  ID  title,  the  BP/OP  ID  string,  and  a  carriage  return  to 
ret^str; 

append  the  BP/OP  Size  title,  the  BP/OP  Size  string,  and  a  carriage 
return  to  ret_str; 

append  the  Axis  title,  the  BP/OP  Axis  string,  and  a  carriage  rehirn  to 
ret_str; 

append  five  carriage  returns  to  ret_str(  hve  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret_str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 

4.6.12  CSU  decode.crossing_pdu 

The  decode.crossing_pdu  CSU  decodes  the  Crossing  Reconaissance  input 
messag..  The  following  paragraphs  provide  design  information  for  this  CSU. 

4.6.12.1  CSU  decode  crossing  pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.12.2  CSU  decode  crossing  pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_crossing_pdu  CSU. 

Syntax  for  invoking  this  fimction: 
output  s  decode_crossing_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"  pdu"  is  a  Recon_type  pointer  containing  the  input  message  to 
be  decoded. 
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OUTPUTS: 

"ret.str"  is  a  character  butfer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements.  None 

c.  Interrupts  and  signals.  None 

d.  Algorithms- 

store  a  null  in  the  first  byte  of  ret_str. 

append  a  carriage  return  to  ret.str. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Bank  Slop  Entry, 

Bank  Slop  Exit, 

Crossing  Length, 

Crossing  Width, 

Crossing  Depth, 

Current  Flow, 

Crossing  ID, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret.str  at  the  end  of  each  field. 

e.  Error  handUng.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode.crossing. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

None 

h.  Logic  flow, 
set  ret.str  to  null; 

append  a  carriage  return  to  ret.str(a  blank  line); 

append  the  Bank  Slope  Entry  title,  the  Bank  Slope  Entry  string,  and  a 
carriage  rehim  to  ret_str; 
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append  the  Bank  Slope  Exit  title,  the  Bank  Slope  Exit  string,  and  a 
carriage  return  to  ret_str; 

append  the  Crossing  Length  title,  the  Crossing  Length  string,  and  a 
carriage  return  to  ret_str; 

append  the  Crossing  Width  title,  the  Crossing  Width  string,  and  a 
carriage  return  to  ret_str; 

append  the  Crossing  Depth  title,  the  Crossing  Depth  string,  and  a 
carriage  return  to  ret_str; 

append  the  Current  Flow  title,  the  Current  Flow  string,  and  a  carriage 
return  to  ret_str; 

append  the  Current  ID  title,  the  Crossing  ID  string,  and  a  carriage 
return  to  ret_str; 

append  four  carriage  returns  to  ret_str(  four  blank  lines); 

append  the  Erst  32  Free  Text  characters  and  a  carriage  to  ret.str; 

append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 

return  ret_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.14  CSU  decode_repeat_pdu 

The  decode_repeat_pdu  CSU  decode  the  Repeat  Artillery  input  message. 

The  following  paragraphs  provide  design  information  for  this  CSU. 

4.6.14.1  CSU  decode_repeat.pda  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.14.2  CSU  decode_repeat_pda  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_repeat_pdu  CSU. 
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Syntax  for  invoking  this  function: 
output »  decode_repeat.pdu(  pdu); 

a.  Input/output  data  clgmgnts. 

INPUTS: 

"  pdu"  is  a  Artillery.type  pointer  containing  the  u^>ut  message 
to  be  decoded 

OUTPUTS: 

"ret.str"  is  a  character  bu^er  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elanents- 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temp)orary  storage  that  contains  the  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 

d  Algorithms, 

store  a  null  in  the  first  byte  of  ret.str. 
append  five  carriage  return  to  ret.str. 
decode  and  append  the  following  fields  to  ret_5tr  in  order: 
repeat  message. 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  t3rpes  ■ 
character  pointer: 
decode.repeat. 

Library  routines: 

sprintf, 

streat, 

stmeat. 

eSUs: 

None. 
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h.  Logic  flOtt- 

set  ret.str  to  null; 

append  hve  carriage  returns  to  reotr; 

append  the  "REPEAT"  message  string  at  the  center  of  a  line  and  a 
carriage  return  to  ret_str; 

append  six  carriage  returns  to  ret.str(  six  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret_str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations-  None 


4.6.15  CSU  decode_pirep_pdu 

The  decode_pirep_pdu  CSU  decodes  tl^  Pilot  Report  input  message.  The 
following  paragraphs  provide  design  information  for  this  CSU. 

4.6.15.1  CSU  decode4iirep_pda  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  missicm  equipment  package. 

4.6.15.2  CSU  decode_pirep_pdu  design. 

The  information  identified  belo»^  represents  the  detailed  design  of  the 
decode_pirep_pdu  CSU. 

Syntax  for  invoking  this  function; 
output  «  decode_pirep_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"pdu"  is  a  PIREP.type  pointer  containing  the  input  message  to 
be  decoded. 
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OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elemgnis. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decod^  message. 

"temp**  is  a  temporary  storage  that  contains  tihe  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret_str. 

append  a  carriage  return  to  ret.str. 

decode  and  app^  die  following  fields  to  retLStr  in  order: 

Visibility, 

Restrictions, 

Cloud  Cover, 

Cloud  Base, 

Cloud  Top, 

Outside  Air  Temperature, 

Barometer, 

Wind  Sf^d, 

Wind  Direction, 

Turbulence  Frequency, 

Turbulence  Intensity, 

Icing  Intensity, 

Icing  Type, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret.str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated”  types  - 
character  pointer: 
decode_pirep, 
visibility_enum_str, 
restriction_enum_str, 
cloud.enum.str, 
direction.enum.str, 
turbfreq.enum_str. 
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turbint_enum_str, 

iceint_enum_str, 

icing_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

None. 

h.  Logic  flow, 
set  ret.str  to  null; 

append  a  carriage  return  to  ret.str(a  blank  line); 

if  Visibility  Type  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Visibility  Type, 
decode  Visibility  Type; 
else 

decode  Visibility  Type  %vith  an  invalid.entry  string; 
append  the  l^ibility  title,  the  decoded  Visibiltity  Type,  and  a  space  to 
ret_str; 

if  Restriction  Type  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  ResttictionType. 
decode  Restriction  Type  into  a  string; 
else 

decode  Restriction  Type  with  an  invalid.entry  string; 
append  the  decoded  RestrictionType  string  aiui  a  carriage  return  to 
ret_str; 

if  Cloud  Cover  Type  is  greater  than  or  equal  to  zero  and  is  less  than  the 
nuxnber  of  possible  Qoud  Cover  Type, 
decode  Coud  Cover  Type  into  a  string; 
else 

decode  Qoud  Cover  Type  widi  an  invalid.entry  string; 
appends  the  Qouds  title,  the  decoded  Qoud  Cover  Type  string  and  a 
ccnnma  widi  a  space  to  ret.str; 

convert  Qoud  Base  into  a  string; 

append  the  Qoud  Base  title,  the  Qoud  Base  string,  and  a  comma  with  a 
space  to  ret_str; 

convert  Qoud  Top  into  a  string; 

append  the  Cloud  Top  title,  the  Qoud  Top  string,  and  two  carriage 
returns  to  ret.str; 
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convert  Outside  Air  Temperature  into  a  string  with  unit  "C"; 
append  the  Outside  Air  Temperature  title  and  the  Outside  Air 
Temperature  string  to  ret_str; 

convert  Barometer  into  a  string  with  two  spaces  after  the  decimal  and 
unit 

append  the  Barometer  title,  the  Barometer  string,  and  two  carriage 
returns  to  ret_str; 

convert  Wind  Speed  into  a  string  with  unit  1CNOTS"; 
append  the  Wind  title,  the  converted  Wind  Speed  string,  and  a  comma 
with  a  space  to  ret_str; 

if  Wind  Direction  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Wind  Speed, 
decode  Wind  Speed  into  a  string; 
else 

decode  Wind  Speed  widi  an  invalid.entry  string; 
append  the  decoded  Wind  Speed  string  and  two  carriage  returns  to 
ret_str; 

if  Turbulence  Frequency  is  greater  dum  or  equal  to  zero  and  is  less  than 
the  number  of  possible  Turbulence  Frequency, 
decode  Turbulence  Frequency  into  a  string; 
else 

decode  Turbulence  Frequotcy  with  an  invalid.entry  string; 
append  the  decoded  Turbulence  Frequency  string  and  a  comma  to 
ret.str; 

if  Turbulence  Intensity  Type  is  greater  than  or  equal  to  zero  and  is  less 
than  the  number  of  possible  Turbulence  Intensity  Type, 
decode  Turbulence  Intensity  Type  into  a  string; 
else 

decode  Turbulence  Intensity  Type  with  an  invalid.entry  string; 
append  the  decoded  Turbulence  Intensity  Type  string,  the  Turbulence 
title,  and  two  carriage  returns  to  ret.str; 

if  Icing  Intensity  is  greater  than  or  equal  to  zero  and  is  less  than  the 
ntunber  of  possible  Icing  Intensity, 
decode  Icing  Intensity  into  a  string; 
else 

decode  Icing  Intensity  wito  an  invalid.entry  string; 
appeiul  the  decoded  Icing  Intensity  string  and  a  space  to  ret.str; 

if  Icing  Type  is  greater  than  or  equal  to  zero  aiul  is  less  than  the  number 
of  possible  Icing  Type. 
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decode  Icing  Type  into  a  string; 
else 

decode  Icing  Type  with  an  invalid.entry  string; 
append  the  decoded  IcingType  string,  the  Icing  title,  and  two  carriage 
returns  to  ret.str; 

append  the  first  32  Free  Text  characters  and  a  carriage  to  ret_str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
rehirn  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitarions.  None 


4.6.16  CSU  decode_cancel_pdtt 

The  decode_cancel_pdu  CSU  decodes  the  Cancel  Artillery  input  message. 

The  following  paragraphs  provide  design  information  for  this  CSU. 

4.6.16.1  CSU  decode.cancel_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  eqmpment  package. 

4.6.16.2  CSU  decode_cancel.4Kla  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_canceLpdu  CSU. 

Syntax  for  invoking  this  function: 
output  a  decode_cancel_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"  pdu"  is  a  Artillery.t3rpe  pointer  containing  the  input  message 
to  be  decoded. 

OUTPUTS: 

"ret.str”  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 
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b.  Lngal  data  elempnt*.  None 


c 


Int 


and  aignala.  None 


d.  Algorithms, 
store  a  null  in  the  first  byte  of  ret_str. 
append  five  carriage  returns  to  ]«t_str. 
decode  and  append  the  following  fields  to  reCstr  in  order: 
cancel  message  string; 

Free  Text  Annotation  String. 


*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 


e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  Other  elements. 

The  following  provide  the  string  values  of  "Enumerated”  types  - 
character  pointer: 
decode.cancel. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

None. 


h.  Logic  flow, 
set  ret^str  to  null; 

append  five  carriage  return  to  ret_str(five  blank  lines); 

append  "CANCEL"  message  string  to  the  center  of  a  line  and  a  carriage 
return  to  ret^str; 

append  six  carriage  returns  to  ret.str(  six  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret_str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitatipns-  None 
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4.6.17  CSU  decodc.check_pdu 

The  decode_check_pdu  CSU  decodes  the  Check  Artillery  input  message.  The 
following  paragraphs  provide  design  mformation  for  this  CSU. 

4.6.17.1  CSU  dccode_check_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.17.2  CSU  decode_check_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_check_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  =  decode_check_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"  pdu"  is  a  Artillery.type  pointer  containing  the  input  message 
to  be  decoded. 

OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements.  None 

c.  Interrupts  and  signals.  None 

d  Algorithms, 

store  a  null  in  the  first  byte  of  ret.str. 
append  five  carriage  returns  to  ret_str. 
decode  and  append  the  following  fields  to  ret_str  in  order: 
check  message  string. 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret^str  at  the  end  of  each  field, 
e.  Error  handling.  None 
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f.  Data  conversion  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode.check. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

None. 

h.  Logic  flow, 
set  ret.str  to  null; 

appeiui  five  carriage  returns  to  ret_str(five  blank  lines); 

appeiui  "CHECK"  message  string  at  the  ^nter  of  a  line  and  a  carriage 
return  to  ret_str; 

append  six  carriage  returns  to  ret_str(  six  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
return  ret_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.18  CSU  decode_cno_pdu 

The  decode_cno_pdu  CSU  decodes  the  Can  Not  Observe  Artillery  input 
message.  The  following  paragraphs  provide  design  information  for  this  CSU. 

4.6.18.1  CSU  decode_cno_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 
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4.6.18^  CSU  deco<le_cno_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_cno_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  =  decode_cno_pdu(  pdu); 

a.  Input /output  data  elpments. 

INPUTS: 

"  pdu"  is  a  Artillery_type  pointer  containing  the  input  message 
to  be  decoded. 

OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp_str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  held. 

c.  Interrupts  and  signals-  None 

d.  Algorithms. 

store  a  mdl  in  the  first  byte  of  ret_str. 
append  a  carriage  return  to  ret^str. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Mission  ID, 

Target  ID, 

Mission  Status, 

Can  Not  Observe  Message  String, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret_str  at  the  end  of  each  held. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode_cno. 
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mission_status_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flow- 
set  ret_str  to  null; 

app>end  a  carriage  return  to  ret_str(a  blank  line); 

append  the  Mission  ID  title,  the  Mission  ID  string,  and  a  carriage  return 
to  ret_str; 

append  the  Target  ID  title,  the  Target  ID  string,  and  a  carriage  return  to 
ret_str; 

if  Mission  Status  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than 
the  number  of  possible  Mission  Status  Type, 
decode  Mission  Status  Type; 
else 

decode  Mission  Stahis  Type  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Mission  Status  title,  the  decoded 
Mission  Status  Typ>e  string  and  a  carriage  return  to  ret_str; 

appeiul  three  carriage  returns  to  ret_str(three  blank  lines); 

append  the  "CAN  NOT  OBSERVE"  message  string  to  ret_str; 

append  four  carriage  returns  to  ret_str(four  blaidc  lines); 
app>end  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitatigns-  None 


4.6.19  CSU  decode_shift_pdu 

The  decode_shift_pdu  CSU  decodes  the  Shift  Artillery  input  message.  The 
following  paragraphs  provide  design  information  for  this  CSU. 
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4.6.19.1  CSU  decode.shift.pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Commuiucations  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.19.2  CSU  decode_shift_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_shift_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  =  decode_shift_pdu(  pdu); 

a.  Input /output  data  elements. 

INPUTS: 

"  pdu"  is  a  Artillery_type  pointer  containing  the  input  message 
to  be  decoded. 

OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 

d  Algorithms. 

store  a  null  in  the  first  byte  of  ret.str. 

append  a  carriage  return  to  ret^str. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Mission  ID, 

Target  ID, 

Mission  Status, 

Fire  for  Effect  logical  Type, 

Shift  Message  String, 

Shift  Instruction  Message  String, 

Free  Text  Annotation  String. 
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*  append  a  carriage  return  to  ret_str  at  the  end  of  each  held. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode.shift, 

mission_status_enum_str, 

logic_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flow, 
set  ret_str  to  null; 

append  a  carriage  return  to  ret_str(a  blank  line); 

append  the  Mission  ID  title,  the  Mission  ID  string,  and  a  carriage  return 
to  ret_str; 

append  the  Target  ID  title,  the  Target  ID  string,  and  a  carriage  return  to 
ret_str; 

if  Mission  Status  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than 
the  number  of  possible  Mission  Status  Type, 
decode  Mission  Status  Type; 
else 

decode  Mission  Status  Type  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Mission  Status  title,  the  decoded 
Mission  Status  Type  string  and  a  carriage  return  to  ret_str; 

if  Fire  for  Effect  Type  is  greater  than  or  equal  to  zero  and  is  less  than  die 
number  of  possible  Fire  for  Effect  Type, 
decode  Fire  for  Effect  Type  into  a  string; 
else 

decode  Fire  for  Effect  Type  with  an  invalid_entry  string; 
invoke  puttogether()  to  append  the  Fire  For  Effect  title,  the  decoded 
Fire  for  Effect  Type  string  and  a  carriage  return  to  ret_str; 

append  two  carriage  returns  to  ret_str; 
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append  the  "SHIFT'  message  string  at  the  center  of  a  line  and  a  carriage 
return  to  ret_str; 

append  nine  character  spaces  to  ret.str; 

append  the  the  Shift  Imtruction  Message  string  and  a  carriage  return  to 
ret_str; 

append  two  carriage  returns  to  ret_str(  two  blank  lines); 
append  the  hrst  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  aiul  a  carriage  to  ret_str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.20  CSU  decode_nwmsn_pdu 

The  decode_nwmsn_pdu  CSU  decodes  the  New  Artillery  input  message. 

The  following  paragraphs  provide  design  information  for  this  CSU. 

4.6.20.1  CSU  decode.nwmsn.pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subftmction  of  a  helicopter  mission  equipment  package. 

4.6J20.2  CSU  decode_nwmsn_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_nwmsn_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  «  decode.nwmsn_pdu(  pdu); 

a.  Input/output  data  etements. 

INPUTS: 

"  pdu"  is  a  Artillery.type  pointer  containing  the  input  message 
to  be  decoded. 
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OUTPUTS: 

"ret.str"  is  a  character  buffet  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

C  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret_.str. 

append  a  carriage  return  to  ret_str. 

decode  and  append  the  following  fields  to  ret^str  in  order: 

New  Aitillerty  Mission  title  String, 

Mission  ID, 

Target  ID, 

Mission  Status, 

Mission  Type, 

Shell  Type, 

Control  Type, 

Fuze  Type, 

Trajectory  Type, 

Fire  for  Effect  logical  Type, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode.nwinsn, 
mission.status.enum.str, 
mission.enum.str, 
shell.enum.str, 
control.enum.str, 
fuze_enum_str, 
trajectory.enum.str, 
logic.enum.str. 

Library  routines: 
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sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flfflae. 

set  ret.str  to  null; 

append  a  carnage  return  to  ret.str; 

append  the  *  NEW  ARTILLERY  MISSION  *  ***  message  string  and  a 
carriage  return  to  ret.str; 

append  the  Mission  ID  title,  the  Mission  ID  string,  and  a  carriage  return 
to  ret.str; 

append  the  Target  ID  title,  the  Target  ID  string,  and  a  carriage  return  to 
ret_str; 

if  Mission  Status  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than 
the  munber  of  possible  Mission  Status  Type, 
decode  Mission  Status  Type; 
else 

decode  Mission  Status  Type  with  an  invalid_entry  string; 
invoke  puttogether()  to  append  the  Mission  Status  title,  the  decoded 
Mission  Status  Type  string  aiul  a  carriage  return  to  ret.str; 

if  Mission  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
numbtf  of  possible  Mission  Type, 
decode  Mission  Type; 
else 

decode  Mission  Type  with  an  invalid_entry  string; 
invoke  puttogetherQ  to  append  the  Mission  Type  title,  the  decoded 
Mission  Type  string  and  a  carriage  return  to  ret_str; 

if  Shell  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
number  of  possible  Shell  Type, 
decode  Shell  Type; 
else 

decode  Shell  Type  with  an  invalid.entry  string; 
invoke  puttogedinrO  h>  apperul  the  Shell  Type  tide,  the  decoded  Shell 
Type  string  and  a  carriage  return  to  ret_str; 

if  Control  Type  is  greater  than  or  equal  to  zero  aiul  it  is  less  than  the 
numb^  of  possible  Control  Type, 
decode  Control  Type; 
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else 

decode  Control  Type  with  an  invalid.entry  string; 
invoke  puttogetherQ  to  append  the  Control  Type  title,  the  decoded 
Control  Type  string  and  a  carriage  return  to  ret.str; 

if  Fuze  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
number  of  possible  Fuze  Type. 

decode  Fuze  Type; 
else 

decode  Fuze  Type  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Fuze  Type  title,  the  decoded  Fuze 
Type  string  and  a  carriage  return  to  ret.str; 

if  Trajectory  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than  the 
number  of  possible  Trajectory  Type. 

decode  Trajectory  Type; 
else 

decode  Trajectory  Type  with  an  invalid_entry  string; 
invoke  puttogether()  to  app>end  the  Trajectory  Type  title,  the  decoded 
Trajectory  T)q)e  string  and  a  carriage  return  to  ret.str; 

if  Fire  for  Effect  Type  is  greater  than  or  equal  to  zero  aiul  it  is  less  dum 
the  number  of  possible  Fire  for  Effect  Type. 

decode  Fire  for  Effect  Type; 
else 

decode  Fire  for  Effect  Type  with  an  invalid^entry  string; 
invoke  puttogether()  to  append  the  Fire  For  Effect  title,  the  decoded 
Fire  for  Effect  Type  string  and  a  carriage  return  to  ret.str; 

append  the  ffrst  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  aiul  a  carriage  to  ret.str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitarions.  None 


4.6,21  CSU  decode_mto_pdu 

The  decode_mto_pdu  CSU  decodes  the  Message  to  Observe  input  message. 
The  following  paragraphs  provide  design  information  for  this  CSU. 
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4.6^1.1  CSU  decodc_into_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6Jtl.2  CSU  decode_mto_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_mto_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  =  decode_mto_pdu(  pdu); 

a.  Input /output  data  elements. 

INPUTS: 

"  pdu"  is  a  Artillery^type  pointer  containing  the  input  message 
to  be  decoded. 

OUTPUTS: 

"ret_str"  is  a  character  bujfier  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret_str. 

append  a  carriage  return  to  ret.str. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Mission  ID, 

Target  ID, 

Mission  Status, 

Message  To  Observe  message  String, 

Request  Adjustment, 

Enter  As  Target  Logic  Type, 

End  Mission  Logic  Type, 

Free  Text  Annotation  String. 
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*  app«ui  a  carriage  return  to  ret.str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated”  types  - 
character  pointer: 
decode.mto, 

mission_status_enum_str, 

logic_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flow, 
set  ret.str  to  null; 

append  a  carriage  return  to  ret_str(a  blank  line); 

append  the  Mission  ID  title,  the  Mission  ID  string,  aitd  a  carriage  rehim 
to  ret^str; 

append  the  Target  ID  title,  the  Target  ID  string,  and  a  carriage  return  to 
ret_str; 

if  Mission  Status  Type  is  greater  dum  or  equal  to  zero  and  it  is  less  than 
the  number  of  possible  Mission  Status  Type, 
decode  Mission  Status  Type; 
else 

decode  Mission  Status  Type  with  an  invalid.entry  string; 
invoke  puttogetherQ  to  append  the  Mission  Status  title,  the  decoded 
Mission  Status  Typ>e  string  and  a  carriage  return  to  ret_str; 

append  the  "MESSAGE  TO  OBSERVER"  string  at  the  center  of  a  line 
and  a  carriage  return  to  ret.str; 

if  Request  Adjustment  Type  is  greater  than  or  equal  to  zero  and  it  is 
less  than  the  numba  of  possible  Logical  T3rpe. 
decode  Request  Adjustment  Logical  Type; 
else 


Page  351 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


decode  Request  Adjustment  Logical  Type  with  an  invalid.entry 
string; 

invoke  puttogether()  to  append  the  Request  Adjustment  title,  the 
decoded  Request  Adjustment  Logical  Type  string  and  a  carriage 
return  to  ret_str; 

if  Enter  As  Target  Logical  Type  is  greater  than  or  equal  to  zero  and  it  is 
less  than  the  number  of  possible  Logical  Type, 
decode  Enter  As  Target  Logical  Type; 
else 

decode  Enter  As  Target  Logical  Type  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Enter  As  Target  title,  the  decked 
Enter  As  Target  Logical  Typ>e  string  and  a  carriage  return  to 
ret_str; 

if  End  Mission  Logical  Type  is  greater  than  or  equal  to  zero  and  it  is  less 
than  the  number  of  possible  Logical  Type, 
decode  End  Mission  Logical  Type; 
else 

decode  End  Mission  Logical  Type  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  End  Mission  title  ,  the  decoded  End 
>^sion  Logical  T)rpe  string  and  a  carriage  return  to  ret.str; 

append  two  carriage  retuoms  to  ret.str(  two  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret_str; 
return  ret_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4L6.22  CSU  decode_shot_pdu 

The  decode_shot_pdu  CSU  decodes  the  Shot  Artillery  input  message.  The 
following  paragraphs  provide  design  information  for  this  CSU. 
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4.6,22.1  CSU  decode_shot_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.22J2  CSU  decode_shot_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_shot_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  =  decode_shot_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

’’  pdu"  is  a  Artillery.type  pointer  containing  the  input  message 
to  be  decoded. 

OUTPUTS: 

"ret_str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp_str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

"i"  is  a  loop  counter. 

c.  Interrupts  and  signals-  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret.str. 

append  a  carriage  retiun  to  ret.str. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Shot  Message  String, 

Mission  ID, 

Target  ID, 

Mission  Status  Type, 

Shot  Fire  Message  String, 

Free  Text  Annotation  String. 
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*  append  a  carriage  return  to  reLstr  at  the  end  of  each  Held. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode_shot, 

mission_status_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flow- 
set  ret.str  to  null; 

append  a  carriage  return  to  ret.str(a  blank  line); 

append  the  Mission  ID  title,  the  Mission  ID  string,  and  a  carriage  return 
to  ret.str; 

append  the  Target  ID  title,  the  Target  ID  string,  and  a  carriage  return  to 
ret_str; 

if  Mission  Status  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than 
the  number  of  possible  Mission  Status  Type, 
decode  Mission  Status  Type; 
else 

decode  Mission  Status  Type  with  an  invalid_entry  string; 
invoke  puttogether()  to  append  the  Mission  Status  title,  the  decoded 
Mission  Status  T)rpe  string  and  a  carriage  return  to  ret_str; 

append  three  carriage  returns  to  ret.str; 

append  the  "*  *  SHOT  FIRED  *  *"  message  at  the  center  of  a  line  to 
ret_str; 

append  four  carriage  returns  to  ret_str(  four  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret_str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret_str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 
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j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.23  CSU  decode.splash.pdu 

The  decode_splash_p<lu  CSU  decodes  the  Splash  Artillery  input  message. 

The  following  paragraphs  provide  design  iidormation  foe  this  CSU. 

4.6.23.1  CSU  decode_splash_pdtt  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine*interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  commuxucations 
subfimction  of  a  helicopter  mission  equipment  package. 

4.6.23.2  CSU  decode_splash.pdu  desigiu 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_splash_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  a  decod€_splash.pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"  pdu"  is  a  Artillery.type  pointer  containing  the  input  message 
to  be  decoded. 

OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 
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d.  Algorithms. 

store  a  null  in  the  hrst  byte  of  ret.str. 
append  a  carriage  return  to  ret.str. 

decode  and  append  the  following  helds  to  ret_str  in  order: 

Mission  ID, 

Target  ID, 

Mission  Status  Type, 

Splash  message  string. 

Round  Fired, 

Second  to  Impact  time. 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret_str  at  the  end  of  each  held. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use_of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  t3rpes  • 
character  pointer: 
decode.splash, 
mission_status_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flow. 
set  ret.str  to  null; 

app)end  a  carriage  return  to  ret_str(a  blank  line); 

append  the  Mission  ID  title,  the  Mission  ID  string,  and  a  carriage  return 
to  ret_str; 

append  the  Target  ID  title,  die  Target  ID  string,  and  a  carriage  return  to 
ret_str; 

if  Mission  Status  Type  is  greater  than  or  equal  to  zero  and  it  is  less  than 
the  number  of  possible  Mission  Status  Type, 
decode  Mission  Status  Type; 
else 

decode  Mission  Status  Type  with  an  invalid_entry  string; 
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invoke  puttogether()  to  append  the  Mission  Status  title,  the  decoded 
Mission  Status  Type  string  and  a  carriage  return  to  ret.str; 

append  two  carriage  returns  to  ret_str; 

append  the  "•  *  SPLASH  •  message  at  the  center  of  a  line  and  a 
carriage  return  to  ret^str; 

convert  Rounds  Fired  into  a  string; 

invoke  puttogether()  to  append  the  Rounds  title,  the  converted 
Rounds  Fired  string,  and  a  carriage  return  to  ret.str; 

convert  Impact  Time  into  a  string; 

invoke  puttogether()  to  append  the  Second  to  Impact  title,  the 
convert^  Impact  Time  string,  and  a  carriage  return  to  ret.str; 

append  two  carriage  returns  to  ret_str(  two  blank  lines); 

append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 

append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret_str; 

return  ret_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6,24  CSU  decode_eom_pdu 

The  decode_eom_pdu  CSU  decodes  the  End  Of  Mission  Artillery  input 
message.  The  following  paragraphs  provide  design  information  for  this  CSU. 

4.6.24.1  CSU  decode_eom_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man>machine-inte^ace  (MMl)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.24.2  CSU  decode_eom_pda  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_eom_pdu  CSU. 

S3mtax  for  invoking  this  function; 
output  *  decode_eom_pdu(  pdu); 
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a.  Input/output  data  pipments. 

INPUTS: 

"  pdu"  is  a  Recon.type  pointer  containing  the  input  message  to 
be  decoded. 

OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  nidi  in  the  first  byte  of  ret_str. 

append  a  carriage  return  to  ret.str. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Mission  ID, 

Target  ID, 

Mission  Status  T)rpe, 

End  Of  Mission  message  string. 

Disposition  Type, 

Record  As  Target  Logical  Type, 

Casualties, 

Point  Number, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret.str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pester: 
decode.eom, 

mission.status.enum.str, 

disposition.enum.str, 

logic.enum.str. 
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Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flow, 
set  ret_str  to  null; 

append  a  carriage  return  to  relLStr(a  blank  line); 

append  the  Mission  TO  tide,  the  Mission  ID  string,  and  a  carriage  return 
to  ret_str; 

append  the  Target  ID  title,  the  Target  ID  string,  and  a  carriage  return  to 
ret_str; 

if  Mission  Status  Type  is  greater  dian  or  equal  to  zero  and  it  is  less  than 
the  number  of  possible  Mission  Status  Type, 
decode  Mission  Status  Type; 
else 

decode  Mission  Status  Type  with  an  invalicLentiy  string; 
invoke  puttogether()  to  append  the  Mission  Status  title,  the  decoded 
Missi<m  Status  Type  strii^  and  a  carriage  return  to  ret^str; 

append  a  carriage  return  to  retjstr; 

append  the  *  END  OF  MISSION  *  message  at  the  center  of  a  line 
and  two  carriage  returns  to  retjstr; 

if  Disposition  Type  is  greater  than  or  equal  to  zero  and  it  is  less  tftan  die 
number  of  possible  Disposition  Type, 
decode  Disposition  Type; 
else 

decode  Disposition  Type  with  an  invalid.entry  string; 
invoke  puttogetherQ  to  append  the  Disposition  title,  the  decoded 
Imposition  Type  string  and  a  carriage  return  to  ret_str; 

if  Record  As  Target  Type  is  greater  than  or  equal  to  zero  and  it  is  less 
than  the  number  of  possible  Logical  Type, 
decode  Record  As  Target  Type; 
else 

decode  Record  As  Target  Type  with  an  invalid.entry  string; 
invoke  puttogedierO  to  appeiui  die  Record  As  Target  tide,  the  decoded 
Record  As  Target  logical  Type  string  and  a  carriage  return  to 
ret_str; 
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convert  Casualties  Number  into  a  string; 

invoke  puttogether()  to  append  the  Casualties  title,  the  converted 
Casualties  Number  string,  and  a  carriage  return  to  ret.str; 

append  the  Point  Number  title,  the  Point  Number  string,  and  two 
carriage  returns  to  ret^str; 

append  the  hrst  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
return  ret_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.25  CSU  decode_status_pdu 

The  decode.status.pdu  CSU  decodes  the  Status  input  message.  The 
following  paragraphs  provide  design  iitformation  for  this  CSU. 

4.6.25.1  CSU  decode_status.pda  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.25.2  CSU  decode.status^dtt  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_status_pdu  CSU. 


Syntax  for  invoking  this  function: 
output  s  decode_status_pdu(  pdu); 


a. 


Input/output  data  el 


INPUTS: 

"  pdu"  is  a  Status.type  pointer  containing  the  input  message  to 
be  decoded. 


I 

I 

I 

I 
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OUTPUTS: 

"ret.str"  is  a  character  butfer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  glgmgnts. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

"i,  j"  are  loop  counters. 

c.  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  nidi  in  the  first  byte  of  ret_str. 

append  a  carriage  return  to  ret_str. 

decode  and  append  the  following  fields  to  ret_str  in  order: 

Fuel  Status, 

Failed  Equipments  Type, 

Hell  Fires, 

Stingers, 

Rockets, 

Rounds, 

Request  type. 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 


e.  Error  handling.  None 

f.  Data  COnYCTSm  None 


g.  Use  of  other  cl« 

The  following  provide  the  string  values  of  "Enumerated"  types 
character  pcnnter: 
decode.status, 
fail_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 


None. 
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h.  Logic  flow. 

set  ret.str  to  null; 

append  a  carriage  return  to  ret.str(a  blank  line); 

convert  Fuel  into  a  string  with  unit  "LBS'*  and  a  carriage  return  to 
ret^str; 

repeat  for  three  failed  equipments 

if  Failed  Equipment  T)rpe  is  greater 
than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Faited  Equipment, 
decode  Failed  Equipment  Type; 
else 

decode  Failed  Equipment  with  an 
invalid.entry  string; 
append  the  Failed  Equipment  title,  the 
decoded  Failed  Equipment  Type  string,  and  a 
carriage  return  to  ret_str; 

convert  Hell  Fires  into  a  string; 

append  the  Hell  Fires  title,  the  converted  Hell  Fires  string,  and  a 
carriage  return  to  ret_str; 

convert  Stingers  into  a  string; 

append  the  Stingers  title,  the  converted  Stingers  string,  and  a  carriage 
return  to  ret_str; 

convert  Rockets  into  a  string; 

append  the  Rockets  title,  the  converted  Rockets  string,  and  a  carriage 
return  to  ret_str; 

convert  Rovinds  into  a  string; 

append  the  Roimds  title,  the  converted  Rouiuis  string,  and  a  carriage 
return  to  ret.str; 

if  Request  Type  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Request  Type 
decode  Request  Type; 

else 

decode  Request  Type  with  an  invalid_entry  string; 

append  the  Request  T3rpe  title,  the  decoded  Request  Type  string,  and  a 
carriage  return  to  ret.str; 

append  two  carriage  returns  to  ret_str(  two  blank 

lines); 

append  the  first  32  Free  Text  characters  and  a  carriage  to  ret_str; 
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append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
return  ret_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.26  <3U  decode_reqttest_pdtt 

The  decode_request4>du  CSU  decodes  the  Request  input  message.  The 
following  paragraphs  provide  design  information  for  this  CSU. 

4.6.26.1  CSU  decode.request_pdu  requirements. 

This  CSU  satisHes  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-inte^ace  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.6.26J2  CSU  decode.request^dtt  design* 

The  information  identified  below  represents  the  detailed  design  of  the 
decode.request^du  CSU. 

Syntax  for  invoking  this  function; 
output  s  decode_request_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"pdu"  is  a  Request_type  pointer  containing  the  input  message  to 
be  decoded. 

OUTPUTS: 

"ret.str"  is  a  character  buftm  of  sizel8x36  containing  die  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str”  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  tempevary  decoded  message. 

"temp*  is  a  tem^rary  storage  that  contains  the  integer  value  of 
a  message  field. 
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c  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret.str. 

append  a  carriage  return  to  ret.str. 

decode  and  append  the  following  fields  to  ret_str  in  order: 

Report  T)rpe, 

Recon  Type, 

Free  Text  Aimotation  String. 

*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode.request, 
report_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flow, 
set  ret_str  to  null; 

append  a  carriage  return  to  ret_str(a  blank  line); 

if  Report  Type  is  greater  than  or  equal  to  zero  and  is  less  than  the 
numl^  of  possible  Report  Type 
decode  Report  Type; 

else 

decode  Report  Type  with  an  invalid.entry  string; 
invoke  puttogethn  to  append  the  Report  Type  title,  the  decoded  Report 
Type  string,  and  a  carriage  return  to  ret_str; 

if  Report  type  is  equal  to  Reconaissance 

if  Reran  Type  is  greater  than  or  equal  to  zero  and  is  less 
than  the  number  of  possible  Reran  Type 
decode  Recon  Type; 

else 

decode  Reran  Type  with  an 
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invalid_entry  string; 

invoke  puttogether  to  append  the  Recon  ‘^ype  title,  the 
decoded  Recon  Type  strii^  and  a  carriage  return  to  ret.str; 

else 

append  a  carriage  to  ret.str; 

append  nine  carriage  returns  to  ret.str(nine  blank 
lines); 

append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret_str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.27  CSU  decode.nbcl_pdu 

The  decode.nbcl.pdu  CSU  decodes  the  Nuclear,  Biological,  Chemical  of 
Type  one  input  message.  The  following  paragraphs  provide  design 
information  for  this  C^. 

4.6.27.1  CSU  decode.nbcl.pdtt  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMl)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

A.SJL72.  CSU  decode.nbcl.pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_nbcl.pdu  CSU. 

Syntax  for  invoking  this  function: 
output  =  decode.nbcl.pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"  pdu"  is  a  NBC.type  pointer  containing  the  input  message  to  be 
decoded. 
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OUTPUTS: 

"ret_str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

c.  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret.str. 
append  a  carriage  return  to  retjstr. 

decode  and  append  the  following  fields  to  ret.str  in  order: 

Description  Type, 

Burst  Type, 

Delivered  By, 

Cloud  Height  Unit, 

Cloud  Height, 

Cloud  Description, 

Flash  Bang  Time, 

Start  Time, 

Stop  Time, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Eniimerated"  t3rpes  > 
character  pointer: 
decode_nbcl, 
nbc_desc_enum_str, 
burst_enum_str, 
delivery_enum_str, 
cloud_hgt_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 
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decode_time, 

puttogether. 

h.  Logic  flow- 

set  ret_str  to  null; 

append  a  carriage  return  to  ret_str; 

append  the  "»»  NUCLEAR  BLAST  ««"  message  string  at  the 
center  of  a  line  and  a  carria^  return  to  ret_str; 

if  Description  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Description  Type, 
decode  Description  Type  into  a  string; 
else 

decode  Description  Type  with  an  invalidjentry  string; 
invoke  puttogether()  to  append  the  Description  Type  title,  the  decoded 
Description  Type  string  aiul  a  carriage  return  to  retjstr; 

if  Burst  Type  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Burst  Type, 
decode  Burst  Type  into  a  string; 
else 

decode  Burst  Type  with  an  invalicLentry  string; 
invoke  puttogether()  to  append  the  Burst  Type  title,  the  decoded  Burst 
Type  string  ai^  a  carriage  return  to  ret.str; 

if  Delivered  By  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Delivered  By  Type, 
decode  Deliver^  By  Type  into  a  striitg; 
else 

decode  Delivered  By  Type  widt  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Delivered  By  Type  title,  the 
decoded  Delivered  By  Type  string  and  a  carriage  return  to  ret_str; 

if  Cloud  Height  Unit  Type  is  greater  than  or  equal  to  zero  aiul  is  less 
than  the  number  of  possible  Cloud  Height  Unit  Type, 
decode  Cloud  Height  Unit  Type  into  a  string; 
else 

decode  Qoud  Height  Uiut  Type  with  an  invalid_entry  strir^ 
invoke  puttogetherQ  to  append  the  Coud  Height  Unit  Type  tide,  the 
decoded  Qoud  Height  Unit  Type  string  and  a  carriage  return  to 
ret.str; 

convert  the  Qoud  Height  into  a  string; 

append  the  Qoud  Height  tide,  the  converted  Cloud  Height  string,  and 
a  carriage  return  to  ret.str; 
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append  the  Cloud  Description  title,  the  Cloud  Description  string,  and  a 
carriage  return  to  ret.str; 

convert  the  Flash  Bang  Time  into  a  string  with  unit  "SECONDS"; 

append  the  Flash  Bang  Time  title,  the  converted  Flash  Bang  Time 
string,  and  a  carriage  return  to  ret.str; 

invoke  decode_time  to  decode  the  Start  Time; 

append  the  Start  Time  title,  the  decoded  Start  Time,  and  a  carriage 
return  to  ret_str; 

invoke  decode_time  to  decode  the  Stop  Time; 

append  the  Stop  Time  title,  the  decoded  Stop  Time,  and  a  carriage 
return  to  ret_str; 

append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 

append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret_str; 

return  ret_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.28  CSU  decode_nbc4_pdu 

The  decode_nbc4_pdu  CSU  decodes  the  Nuclear,  Biological,  Chemical  of 
Type  four  input  message.  The  following  paragraphs  provide  design 
information  for  this  CSU. 

4.6.28.1  CSU  decode_nbc4_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.6.28J2  CSU  decode_nbc4_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_nbc4_pdu  CSU. 
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Syntax  for  invoking  this  functioru 
output «  decode.nbc4_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"pd  u"  is  a  NBC.type  pointer  containing  the  input  message  to  be 
decoded. 

OUTPUTS: 

"ret_str"  is  a  character  butfer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str'*  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  ti\e  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 

d.  Alsorithms- 

store  a  null  in  the  first  byte  of  ret;_str. 

append  a  carriage  return  to  ret.str. 

decode  and  appi^  the  following  fields  to  ret_str  in  order: 

Description  Type, 

Burst  Type, 

Deliver^  By, 

Qoud  Height  Unit, 

Qoud  Ifei^t, 

Qoud  De^ption, 

Dose  Rate, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  reLstr  at  the  end  of  each  field. 

e.  Error  handUng.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode_nbc4, 
nbc.desc.enum.str, 
burst.enum.str. 
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delivery_enum_str, 

cloud_hgt_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flow. 

set  ret.str  to  a  null  string; 

append  a  carriage  return  to  ret.str; 

append  the  CHEMICAL  OR  BIOLOGICAL  *  ”  message  string  at  the 
center  of  a  line  and  two  carriage  returns  to  ret_str; 

if  Description  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Description  Type, 
decode  Description  Type  into  a  string; 
else 

decode  Description  Type  with  an  invalid_entry  string; 
invoke  puttogether()  to  append  the  Description  Type  title,  the  decoded 
Description  Type  string  and  a  carriage  return  to  ret.str; 

if  Burst  Type  is  greater  than  or  equal  to  zero  and  is  less  than  the 
nuinber  of  possible  Burst  Typ>e. 
decode  Burst  Type  into  a  string; 
else 

decode  Burst  Type  with  an  invalid_entry  string; 
invoke  puttogetherQ  to  append  the  Burst  Type  title,  the  decoded  Burst 
T3q>e  string  axui  a  carriage  return  to  ret_str; 

if  Delivered  By  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Delivered  By  Type, 
decode  Delivered  By  Type  into  a  string; 
else 

decode  Delivered  By  Type  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Delivered  By  Type  title,  the 
decoded  Delivered  By  Type  string  and  a  carriage  return  to  ret.str; 

if  Cloud  Height  Unit  Type  is  greater  than  or  equal  to  zero  and  is  less 
than  the  number  of  possible  Cloud  Height  Unit  Type, 
decode  Cloud  Height  Unit  Type  into  a  string; 
else 

decode  Qoud  Height  Unit  Type  with  an  invalid.entry  string; 
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invoke  puttogether()  to  append  the  Cloud  Height  Unit  Type  title,  the 
decoded  Cloud  Height  Unit  Type  string  and  a  carriage  return  to 
ret_str; 

convert  the  Cloud  Height  into  a  string; 

app>end  the  Cloud  Height  tide,  the  converted  Cloud  Height  string,  and 
a  carriage  return  to  ret.str; 

append  the  Cloud  Description  tide,  the  Qoud  Description  strmg,  and  a 
carriage  return  to  ret.str; 

convert  the  Dose  Rate  into  a  string; 

append  the  Dose  Rate  tide,  the  converted  Dose  Rate  string,  and  a 
carriage  return  to  ret.str; 

append  two  carriage  returns  to  ret_str(two  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret_str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret_str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

4.6,29  CSU  decode_nbc5_pdu 

The  decode_nbc5_pdu  CSU  decodes  the  Nuclear,  Biological,  Chemical  of 
Type  five  input  message.  The  following  paragraphs  provide  design 
information  for  this  CSU. 

4.6J29.1  CSU  decode_nbc5_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.29.2  CSU  decode_nbc5_pdtt  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_nbc5_pdu  CSU. 

S3mtax  for  invoking  this  function: 
output  *  decode_nbc5.pdu(  pdu); 
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a. 


Input/output  data  elci 


INPUTS: 

"  pdu"  is  a  NBC.type  pointer  containing  the  input  message  to  be 
decoded. 


OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 

b.  Local  data  elements.  None. 

c  Interrupts  and  signals.  None 

d.  Algorithms, 

store  a  null  in  the  first  byte  of  ret.str. 
append  five  carriage  returns  to  ret_str. 
append  the  following  fields  to  ret.str  in  order: 
message  string; 

Free  Text  Annotation  String. 


*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 


e.  Enoi  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types 
character  pointer: 
decode.nbcS. 

Library  routines: 

spzintf, 

strcat, 

stmcat. 

CSUs: 

None. 


h.  Logic  flow- 

place  a  null  to  ret.str; 

append  five  carriage  returns  to  ret_str(five  blank  lines); 

append  the  "NBC  NEGATIVE"  message  string  at  the  center  of  a  line 
and  a  carriage  return  to  ret_str; 

append  six  carriage  returns  to  ret.str(six  blank  lines); 
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append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
return  ret_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

4.6.30  CSU  decode.mijLpdu 

The  decode_mijLpdu  CSU  decodes  the  Meaconing,  Intrusion,  Jamming 
Interface  input  message.  The  following  paragraphs  provide  design 
information  for  this  CSU. 

4.6.30.1  CSU  decode.mijLpdu  i«quirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine>interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.30.2  CSU  decodc.mijLpdtt  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_mijLpdu  CSU. 

S}mtax  for  invoking  this  function: 
output  =  decode_miji_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"pdu"  is  a  MIJLtype  pointer  containing  the  input  message  to  be 
decoded. 

OUTPUTS: 

"ret.str"  is  a  character  buffer  of  sizel8x36  containing  die  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  deood^  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 
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"i,  j"  are  integer  loop  counters. 

"tempi”  is  a  64  bit  float  storage. 

c.  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret_str. 

append  a  carriage  return  to  ret.str. 

decode  and  append  the  following  fields  to  ret_str  in  order: 

Affect^  Radio  Frequency, 

Programmed  Frequency!, 

Start  Time, 

Stop  Time, 

Description, 

Percent  Lost, 

Type, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  ret_str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g-  Use  Qf. Other  filfiments. 

The  following  provide  the  string  values  of  "Enumerated"  types  * 
character  pointer: 
decode.miji, 
description_eniun_str. 

Library  routines: 

sprintf, 

street, 

stmeat, 

for-loop. 

eSUs: 

freq_hertz, 

decode.time, 

puttogether. 

h.  Logic  flow, 
place  a  null  to  ret.str; 

append  a  carriage  return  to  ret.str(a  blank  line); 

invoke  fireq_hertz  to  decode  the  Affected  Radio  Frequency  to  its 
appriorate  unit  "kilo.  Mega,  or  Giga"  Hertz. 
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append  the  Affected  Radio  Frequency  title,  the  decoded  Affected 
Radion  Frequency,  and  a  carriage  return  to  ret.str; 

repeat  four  times 

invoke  freq_hertz  to  decode  the  Programmed  Frequency 
to  its  appriorate  unit  "kilo.  Mega,  or  Giga"  Hertz, 
append  the  Programmed  Frequency  title,  the  decoded 
Programmed  Frequency,  and  a  carriage  return  to  ret_str; 

invoke  decode_time  to  decode  the  Start  Time; 

append  the  Start  Time  title,  the  decode  Start  Time,  and  a  carriage 
return  to  ret_str; 

invoke  decode.time  to  decode  the  Stop  Time; 

append  the  Stop  Time  title,  the  decode  Stop  Time,  and  a  carriage  return 
to  ret_str; 

if  Description  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Description  Type, 
decode  Description  Type  into  a  string; 
else 

decode  Description  Type  with  an  invalid_entry  string; 
append  the  Description  title,  the  decoded  Description  Type,  and  a 
carriage  return  to  ret_str; 

convert  Percent  Lost  into  a  string  with  xinitTERCENT"; 
append  the  Percent  Lost  title,  the  converted  Percent  Lc»t  string,  and  a 
carriage  return  to  ret.str; 

if  Type  is  greater  than  or  equal  to  zero  and  is  less  than  the  number  of 
possible  Type, 
decode  Type  into  a  string; 
else 

decode  Type  with  an  invalid_entry  string; 
append  the  T3q}e  title,  the  decoded  Type,  and  two  carriage  returns  to 
ret_str; 

append  the  first  32  Free  Text  characters  and  a  carriage  to  ret_str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 
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4.6.31  CSU  decode_dnav_pdu 

The  decode_dnav_pdu  CSU  decodes  the  Downed  Air  Vehicle  Report  input 
message.  The  following  paragraphs  provide  design  information  for  this  CSU. 

4.6.31.1  CSU  decode_dnav_pdtt  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfimction  of  a  helicopter  mission  equipment  package. 

4.6.31.2  CSU  decode_dnav_pdtt  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_dnav_pdu  CSU. 

Syntax  for  invoking  this  function: 
output  s  decode_dnav_pdu(  pdu); 

a.  Input/output  data  elements. 

INPUTS: 

"  pdu"  is  a  DNAV_type  pointer  containing  the  input  message  to 
be  decoded. 

OUTPUTS: 

"ret.str"  is  a  character  bu^er  of  sizel8x36  containing  die  decoded 
message  string  to  be  returned. 

b.  Local  data  elements. 

"temp.str"  is  a  static  unsigned  char  buffer  of  size  36  that 
ccmtains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

c  Interrupts  and  signals.  None 

d.  Algorithms. 

store  a  null  in  the  first  byte  of  ret_str. 

append  a  carriage  return  to  ret.str. 

decode  and  append  the  following  fields  to  ret_str  in  order: 

Aircraft  Type, 

Airaaft  Status, 


Page  376 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


Pilot  Status, 

Free  Text  Annotation  String. 

*  append  a  carriage  return  to  retLStr  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  > 
character  pointer: 
decode.dnav, 
aircraft.enum.str, 
aircraft_status_enum_str, 
pilot_status_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flow. 

initialize  ret.str  to  a  null  string; 

append  a  carriage  return  to  ret.str(a  blank  line); 

if  Aircraft  Type  is  greater  duun  or  equal  to  zero  and  it  is  less  than  the 
number  of  possible  Aircraft  Type, 
decode  Aircraft  Type; 
else 

decode  Aircraft  Type  with  an  invalid.entry  string; 
invoke  puttogetherQ  to  append  the  Aircraft  Type  title,  the  decoded 
Aircraft  Type  string  and  a  carriage  return  to  ret_str; 

if  Aircraft  Status  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  pos^le  Aircraft  Status, 
decode  Aircraft  Status; 
else 

decode  Aircraft  Status  with  an  invalid_entry  string; 
invoke  puttogether()  to  append  the  Aircraft  Status  title,  the  decoded 
Akcraft  Status  string  and  a  carriage  return  to  ret_str; 

if  Pilot  Status  is  greater  than  or  equal  to  zero  and  is  less  than  the 
number  of  possible  Pilot  Status, 
decode  Pilot  Status; 


Page  377 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


else 

decode  Pilot  Status  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Pilot  Status  title,  the  decoded  Pilot 
Status  string  and  a  carriage  return  to  ret.str; 

append  eight  carriage  returns  to  ret_str(eight  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.32  CSU  decode_movcmd_pdu 

The  decode.movcmd.pdu  CSU  decodes  the  Move  Commaiui  input  message. 
The  following  paragraphs  provide  design  information  for  this  C^. 

4.6.32.1  CSU  decode_movcmd_pdu  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.322  CSU  decode.movcmd_pdu  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
decode_movcmd_pdu  CSU. 

Syntax  for  invoking  this  function; 

output  =  decode_movcmd_pduv  input  message  pointer  of  Move.type); 
a.  Input/output  data  elements. 

INPUTS: 

"pdu"  is  a  Move.type  pointer  containing  the  input  message  to 
be  decoded. 

OUTPUTS: 

"ret.str”  is  a  character  buffer  of  sizel8x36  containing  the  decoded 
message  string  to  be  returned. 
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b.  Local  data  elements. 

"temp_str"  is  a  static  unsigned  char  buffer  of  size  36  that 
contains  the  temporary  decoded  message. 

"temp"  is  a  temporary  storage  that  contains  the  integer  value  of 
a  message  field. 

c.  Interrupts  and  signals.  None 

d.  Algorithms, 
initialize  ret.str  to  null. 
ap()end  a  carriage  return  to  ret^str. 

decode  and  append  the  following  fields  to  ret_str  in  order: 

Target  ID, 

Task, 

Who, 

When, 

Where, 

Free  Text  Aimotation  String. 

*  append  a  carriage  return  to  ret.str  at  the  end  of  each  field. 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

The  following  provide  the  string  values  of  "Enumerated"  types  - 
character  pointer: 
decode.movcmd, 
task_enum_str, 
who«enum_str, 
when_enum_str. 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

puttogether. 

h.  Logic  flow. 

initialize  ret_str  to  a  null  string; 
append  a  carriage  return  to  ret^str; 

append  the  Targe  ID  title,  the  Targe  ID  string,  and  a  carriage  return  to 
ret_str; 
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if  Task  is  greater  than  or  equal  to  zero  and  it  is  less  than  the  number  of 
possible  Task, 
dec^e  Task; 
else 

decode  Task  with  an  invalid^entry  string; 
invoke  puttogether()  to  append  the  Task  title,  the  decoded  Task  string 
and  a  carriage  return  to  ret_str; 

if  Who  is  greater  than  or  equal  to  zero  and  is  less  than  the  number  of 
p>ossible  Who  list, 
decode  Who; 
else 

decode  Who  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  Who  title,  the  decoded  Who  string 
and  a  carriage  return  to  ret.str; 

if  When  is  greater  than  or  equal  to  zero  and  is  less  than  the  number  of 
possible  When  list, 
decode  When; 
else 

decode  When  with  an  invalid.entry  string; 
invoke  puttogether()  to  append  the  When  title,  the  decoded  When 
string  and  a  carriage  return  to  ret_str; 

append  the  Where  title,  the  Where  string,  and  a  carriage  return  to 
ret_str; 

append  six  carriage  returns  to  ret_str(six  blank  lines); 
append  the  first  32  Free  Text  characters  and  a  carriage  to  ret.str; 
append  the  next  32  Free  Text  characters)  and  a  carriage  to  ret.str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations-  None 


4.6.33  CSU  puttogether 

The  puttogether  CSU  appends  message  title  and  decoded  message  into  a 
temporary  character  string  bufier.  The  following  paragraphs  provide  design 
information  for  this  CSU. 
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4.6.33.1  CSU  puttogether  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.33.2  CSU  puttogether  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
puttogether  CSU. 

Syntax  for  invoking  this  function: 

puttogether(decod^  message,  return  buffer,  message  header); 

a.  Input /output  data  elements. 

INPUTS: 

"temp_str"  is  an  unsigned  character  pointer  containing  the 
decoded  message. 

"msg"  is  an  unsigned  character  pointer  containing  the  message 
title. 

OUTPUTS: 

"ret_str"  is  an  unsigned  character  pointer  containing  the  return 
buffer. 

b.  Local  data  elements.  None 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements, 
data  elements: 

None 

Library  routines: 

strcat. 

CSUs: 

None 
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h.  Logic  flow. 

append  message  title,  decoded  message,  and  a  carriage  return  to  ret.str; 
return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Limitations.  None 


4.6.34  CSU  decode.Ume 

The  decode.time  CSU  decodes  DTG  time.  The  following  paragraphs  provide 
design  information  for  this  CSU. 

4.6.34.1  CSU  decode.time  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  missicm  equipment  package. 

4.6.34JZ  CSU  decode.time  design. 

The  ii\formation  identified  below  represents  the  detailed  design  of  the 
decode_time  CSU. 

Syntax  for  invoking  this  function: 
decode.time(return  buffer,  DTG  time); 

a.  Input/output  data  elements. 

INPUTS: 

"dtg”  is  a  DTG.type  pointer  containing  the  input  DTG  time  o  be 
decked. 

OUTPUTS: 

"temp.str"  is  an  unsigned  character  buffer  of  containing  the 
decoded  time  string  to  be  returned. 

b.  Local  data  elements. 

"month"  is  an  integer  storage. 

"temp_str2"  is  a  static  unsigned  character  buffer  of  size  36 
containing  temporary  Month  string. 


I 


I 

I 
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c.  Interrupts  and  signals.  None 

d  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

Data  elements: 

None 

Library  routines: 

sprintf, 

strcat, 

stmcat. 

CSUs: 

None. 

h.  Logic  flow. 

initialize  temp_str  to  a  null  string  and  temp  .str2  to  initialize  the 
string  buffer; 

append  Day  and  a  space  to  temp.str; 
append  Hour,  Minute,  and  a  space  to  temp„str; 

decode  Month  into  its  appropriate  interpretation  7AN,  FEB,  MAR,  ... 
DEC". 

append  the  decoded  Month  string  and  a  space  to  temp.str; 

append  the  last  two  characters  of  Year  string  to  temp.str; 
return  temp.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 

k.  Umitations.  None 


4.6.35  CSU  freq.herlz 

The  freq.hertz  CSU  decodes  the  the  ir^>ut  frequency  into  its  proper  unit.  The 
following  paragraphs  provide  design  information  for  this  C^. 
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4.6.35.1  CSU  freq.hertz  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.35.2  CSU  freq_hertz  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
freq_hert2  CSU. 

Syntax  for  invoking  this  function: 
freq_hert2(input  frequency,  return  buffer); 

a.  Input /output  data  elements. 

INPUTS: 

"tempi"  is  a  64  bit  float  integer  containing  the  input  frequency  to 
be  decoded. 

OUTPUTS: 

"temp.str"  is  a  character  bxdfex  of  size  36  containing  the  decoded 
frequency  string  to  be  returned. 

b.  Local  data  elements. 

"temp,  temp2"  are  temporary  64  bit  float  storage; 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

Data  elements: 

None. 

Library  routines: 
if  -  else, 

sp  ;tf. 

CSUs: 

None. 


I 
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h.  Lope  flow, 
set  temp  to  zero; 

if  input  frequency  a  kilo  and  is  <  a  million,  convert  it  to  kiloHertz; 
else  if  input  frequency  a  million  and  is  <  a  billion,  convert  it  to 
MegaHertz; 

else  if  input  frequency  >=  a  billion,  convert  it  to  GigaHertz; 
else  append  the  Hertz  unit  to  input  frequency; 
place  the  decoded  input  frequency  to  temp.str; 
return  temp_str  to  caller. 

i.  Data  structures.  None 

j.  Local  data.fil€s  ot  databasg-  None 

k.  Limitations.  None 


4.6.36  eSU  sprintf_UTM 

The  sprintf_UTM  CSU  decodes  the  input  DTG  time.  The  following 
paragraphs  provide  design  information  for  this  CSU. 

4.6.36.1  CSU  sprintf.UTM  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
subfunction  of  a  helicopter  mission  equipment  package. 

4.6.36.2  CSU  sprintf.UTM  design. 

The  ii\formation  identified  below  represents  the  detailed  design  of  the 
sprintf_UTM  CSU. 

Syntax  for  invoking  this  function: 

output  =  sprintf_UTM(address  of  the  input  location); 

a.  Input/output  data  elements. 

INPUTS: 

"utm”  is  a  UTM.type  pointer  contaiiung  the  input  location  to  be 
decoded. 

OUTPUTS: 

"reOtr"  is  a  static  character  buffer  of  size  80  containing  the 
decoded  UTM  string  to  be  returned. 
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b.  Local  data  elements.  None 

c  Interrupts  and  signals.  None 

d  Algorithms.  Ncme 

e.  Error  handling.  None 

f.  Data  conversion.  None 

g.  Use  of  other  elements. 

Data  elements: 

None. 

Library  routines: 

stmcpy. 

CSUs: 

None. 

h.  Logic  flow. 

place  the  two  Sector  Letters  aiul  a  space  to  ret_str; 
append  the  first  four  Easting  characters  and  a  space  to  ret_str; 
append  the  first  four  Northing  characters  and  a  null  character  to 
ret.str; 

return  ret.str  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database-  None 

k.  Limitations.  None 


4.6.37  CSU  sprintf.speed 

The  sprintf.speed  CSU  decodes  the  input  Speed  into  its  string  representation. 
The  following  paragraphs  provide  design  information  for  this  C^. 

4.637.1  CSU  8piintf.speed  requirements. 

This  CSU  satisfies  internally  derived  contractor  requirements  to  detail  an 
implementation  of  a  Digital  Message  Communications  System  compliant 
with  customer  directives  to  provide  a  man-machine-interface  (MMI)  and 
system  behavior  which  emulate  the  digital  message  communications 
svibfunction  (rf  a  helicopter  mission  equipment  package. 
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4.6.37^  CSU  sprintf_speed  design. 

The  information  identified  below  represents  the  detailed  design  of  the 
sprintf.speed  CSU. 

Syntax  for  invoking  this  function: 

output  s  sprintf_spM^(address  of  the  input  speed); 

a.  Input /output  data  elements. 

INPUTS: 

"speed"  is  a  Speed.type  pointer  containing  the  input  ^>eed  to  be 
decoded. 

OUTPUTS: 

"speed.buffer"  is  a  static  character  buffer  of  size  20  containing 
the  decoded  Speed  string  to  be  returned. 

b.  Local  data  elements.  None 

c  Interrupts  and  signals.  None 

d.  Algorithms.  None 

e.  Error  handling.  None 

f.  Data.  miiYgraipn.  None 

g.  Use  of  other  elements. 

Data  elements: 

None. 

Library  routines: 

if -else 
sprintf. 

CSUs: 

None. 

h.  Logic  flow. 

decode  the  unit  of  Speed  type; 

append  Speed  value,  a  space,  and  the  decoded  Speed  unit  string  to 
speed.buffer; 

return  speed.buffer  to  caller. 

i.  Data  structures.  None 

j.  Local  data  files  or  database.  None 
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k.  Limitations-  None 
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5.  DMCC  Global  Data  Elements 

In  writing  C  programs,  great  use  is  made  of  ‘header*  Eles.  These  are 
include  files  that  contain  the  information  necessary  for  multiple  modules  to 
treat  data  in  the  same  way.  For  this  CSQ,  the  header  files  contain  structure 
definitions  that  allow  different  functions  to  fill  selected  data  entities  within 
the  structitfes,  modify  or  use  all  or  parts  of  dioee  structures,  or  pass  data  the 
data  structures  between  fimctions  to  allow  for  the  ordered  manipulation  of 
that  data.  Also  within  the  header  files  are  case  sensitive  statements  that 
control  how  data  is  accessed  or  processed.  They  are  delineated  throu^  the 
use  of  'define'  statements.  Most  of  the  time,  these  items  are  flags  usi^  for 
comparison  within  the  functions.  They  can  also  be  used  as  constants  tot  array 
sizing.  At  compile  time,  the  compiler  exchanges  the  statement  for  the  value 
that  it  is  eqiuted  with.  For  example,  if  the  header  file  "assoc.PDU.h”  is 
included  into  module  X,  then  at  compile  time  if  anywhere  within  the  source 
code  of  module  X  the  fragment  “ASSOC.DATAGRAM”  is  found,  the 
compiler  will  replace  the  fragment  wifi\  the  value  ”1"  becatise  in  the  header 
assoc.PDU.h  is  found  the  statement  '#define  ASSOC.DATAGRAM  1*.  Each 
header  file  may  be  described  in  3  parts.  Part  1  of  the  following  tables  will 
contain  the  structure  definitions,  part  2  of  the  associated  tables  containing  the 
'define'  statements,  and  part  3  (where  applicable)  will  dimension  variables, 
initialize  variables,  or  prototype  functions. 

For  this  CSO  there  are  2  uses  for  the  header  files.  Those  listed  in 
section  5.1.x  are  for  system  use,  while  those  listed  in  section  5.2.x  are  for  die 
General  User  Interface  (GUI)  use. 

5.1  System  Header  files 


5.1.1  assoc_PDU.h 

This  header  file  provides  the  data  structures  and  defiiutions  needed  for 
the  decode^kt  modules  used  to  decode  the  incoming  message  PDU's. 
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5.1.1.1.1  assoc_PDU  structure  assocPDU  type 

Table  4  Struchire  assocPDU^Type 


Item  Name 


Version,  PDUKind 


DataLen 


MultkastGrou 


Protocol 


OriffinatorSite 


torSimuIator 


ResponderSite 


erSimulator 


TransactionID 


Unused 


Description 


Version  -  bits  0:3,  PDUKind  bits  4:7 


■ 


5.1.1.1.2  assoc  PDU  structure  assocPDUWithLLCHeaderType 
Table  5  assocPDUWithLLCHeaderType 


Item  Name  I  Type  bytes  I  Description 


8 


17 


32 


LLCSubLaverHeader 


AssocPDU 


ExtraPaddin 


Structure  j 

1  17 

1  AssocPDU.type 

structure 

\iEnxsm 


5.1.1.1.3  assoc.PDU  structure  ActivateRequestEntry 

Table  6  assocPDU  structure  ActivateRequestEntry 


Item  Name  I  Type  t  bytes  |  Description 


57  AssocPDUWithLLCHeaderT 


AssocPDUWithLLCHeader  I  Structure 


Valid  Char 


MorePaddi 


5.1.1.1.4  assoc_PDU  structure  ActivateRequestBuffeiStructure 


Table  7  assocPDU  structure  ActivateRequestBuffeiStructure 


Item  Name 

Type 

Description  I 

AcdvateRequest 

array  of  ActivatdlequestEntry  types  I 

Page  390 


Docxunfint  ADST/WDL/TR-93-003036 


March  31, 1993 


5.1.1.2  assoc_PDU.h  deiBnc  statenwnts 

Table  8  assoc.PDU.h  define  statements 


Name 

IHZICQIII 

Description 

ASSCX. 


ASSOC. 


ASSOC. 


ASSOC. 


ASSOC. 


ASSOC. 


.DATA_LENGTH 


MULTICAST.GROUP 


PROTOCOL 


.VERSION_AUG_89 


.VERSION 


.UNKNOWN.KIND 


DATA 


ASSOC_P  ADDING 


ASSOC_LAST_KIND 


ASSOC_MULTIPUER 


'BROADCAST 


ASSOC_SIMULATION 


FORT_RUCICER 


ASSOC  DIGITAL.MSG 


[rtiu;^7t*iy:TOT3J^ 


ASSOC_PDU_MIN_LEN 


ASSOC_VER_PADKIND 


DIS_NET 


SIM_NET 


NEW_ALPDU 


CONT_ALPDU 


END_ALPDU 


NO.CONFIRM 


CONFIRM 


NO_ASSOC_LAYER 


UDP_PORT 


HOST_NAME 


SNAP.LENGTH 


ACTIVATE_REQUEST_SHMEM.  96161 
KEY 


PADDING_FOR_ALPDU 


S3!: 


?S3!n 


P3TT 


onMt  within  n>U 


olHti  pointer  within  PDU 


offMt  potottf  %vithin  PDU 


values  for  imotion/ 


values  for  ineettion/ 


values  for  insertion/ 


values  for  insertion/ 


values  for  insertion/ 


values  for  insertion/ 


values  for  irtsertion/ 


values  for  insertion/ 


values  for  insertion/ 


values  for  insertion/ 


values  for  insertion/ 


values  for  insertion/ 


values  for  insertion/ 


values  for  Insertion/ 


values  for  insertion/co 


values  for  insertion/ 


values  for  insertion/ooin 


PDU  prooessinK  codes 


llLU::.. 


in  PDU 


II 


it  *31  it  I 


in  PDU 


in  PDU 


in  PDU 


in  PDU 


in  PDU 


in  PDU 


in  PDU 


In  PDU 


in  PDU 


in  PDU 


1:^ 

rs 

ns 

rs. 

ns 

ns 

ns 


0x4128 


adstS 


8 


codes 


codes 


codes 


codes 


codes 


codes 


codfs 


Network  Interface  codes 


Network  Interfoce  codes 


Network  Interface  codes 


max  activate  requests  that  can  be  stored 


number  of  bytes  to  CO 
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5.1.2  databases.h 

This  header  file  provides  the  data  structures  needed  by  the 
database  storage  hmctions  to  maintain  operating  system  data  for  later 
use. 

5.1.2.1.1  databases  structure  IndirectFirePataBase  type 

Table  9  structure  IiuierectFireDataBase.type 


Item  Name 

IZPe 

Description  | 

valid 

Char 

1 

vehiclelD 

Structure 

6 

velocity 

Structure 

12 

muzzle 

Structure 

24 

projectilelD 

Structure 

6 

EPWsr5(.Jifffr?:r;TTTr»*#7;*Mi 

5.1.2.1.2  databases  structure  DetonatjonPataBase  type 


Table  10  structure  DetonationPataBase.type 


1  Item  Name 

Type 

Description 

HHHIHHHHHHBi 

HHHHH 

valid 

Char 

1 

Location 

Structure 

24 

'  r*  i«  1  V.-  •- 

5.1.2.1.3  databases  structure  VehicleAppearancePataBasc  type 


Table  11  structure  VehicleAppearancePataBase.type 


1  Item  Name 

ISie 

Description 

valid 

Char 

1 

Chanse 

Char 

1 
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5.1.2.1.4  databases  structure ! 


Table  12  structure  StateDataBase.type 


Item  Name 


Description 


state 


DRA 


valid 


time 


iniist 


sendtime 


interval.time 


state_time 


XO 


YO 


ZO 


VXO 


VYO 


VZO 


AXO 


AYO 


AZO 


itchO 


rollO 


-awOdot 


itchOdot 


roIlOdot 


revious 


next 


E 

R 

E 

R 


structufe 


Structure 


Char 


Char 


Structure 


Char 


Double 


Double 


Double 


Double 


Double 


Double 


Float 


Float 


Float 


Float 


Float 


Float 


Float 


Float 


Float 


Float 


Float 


Float 


Initial  X 

22. 

Initial  Y 

22 

Initial  Z 

22 

Vehicle  A 


DeadReckonin 


new  information  fla 


Dead  Reckoning  ON  fla 


TimeStam 


in  linked  list  fla 


time  of  rebroadcast 


rebroadcast  period 


Time  of  last  state 


sition 


sidon 


sidon 


Initial  X  veloci 


Initial  Y  veloci 


Initiai  Z  veloci 


Initial  X  acceleration 


Initial  Y  acceleration 


Initial  Z  acceleration 


Initial  X  yaw 


Initial  Y  pitch 


Initial  Z  roll 


Initial  X  vaw  rate 


Iiutial  Y  pitch  rate 


Initial  Z  roll  rate 


last  element  in  list 


next  element  in  list 


7. 


5.1.2.1.5  databases  structure 


Table  13  structure  SIMActivateRequestDataBase.type 


Item  Name 


Description 
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5.1.2.2  databases.h  define  statements 

Table  14  databases.h  define  statements 


Name 

Value 

MAX_DATAGRAMS 

20 

BUFF_SIZE 

1500 

PDU_NAME_NUM_OF_CHARS 

40 

MAX_ENTmES 

256 

MAX_EVENTS 

16 

ERROR 

-1 

GE_Fulda_Gap 

0 

GE_Hunter_Usaett 

1 

5.1.3  declare_netif.h 

This  header  file  declares  and  dimensions  variables  to  be  used  by 
the  network  interface  software  modules.  Sizes  are  specified  by  define 
statements  in  databasesJi  (5.1.2.2)  and  netif.h  (5.1.24.2).  Tables  5.1.3.1 
and  5.1.3.2  are  not  applicable. 
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5.1.3.3 


declare  netif  dimension  statements 


Table  15  declare.netif  dimension  statements 


Name 


selection 


MAX_DATAGRAMS+lirBUFF_SIZE 


init_DIS_tx_netif  (initialized  to  FALSE) 


init.SlM_tx_netif  (initialized  to  FALSE) 


DIS.rxJndex  (initialized  to  0) 


DIS_rx_etherFd 


DIS_rx_sockFd 


DIS_tx_etherFd 


DIS_tx_sockFd 


DlS.currentPDUNumber  (initialized  to  0) 


SIM_rx_index  (initialized  to  0) 


SIM_rx_etherFd 


SIM_tx_etherFd 


SIM.currentPOUNumber  (initialized  to  0) 


SIM_rx_sockFd 


SIM_tx_sockFd 


iu.Mgr.7n 


31500 


1500 


10 


10 


10 


5,1.4  declare.vars.h 

This  header  file  declares  and  dimensions  variables  to  create  the 
actual  global  shared  memory  variables.  Table  5.1. 4.2  is  not  applicable. 
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5.1.4.1 


declare.vars  structures 


Table  16  deciar.vars  structures 


Structure  Name 


dummy.DRA 


DetDB 


StateDB 


IndFireDB 


VehAppDB  [MAX_ENnTIES] 


jsESsmnm 


SActReqDB  [MAS.ENTTnESl 


StartupTim** 


Time.Zone 


itartup_TimeSf.i'rH 


IndirectrireDataBase. 


VehicleAppearanceDataBase.t 

vpe 


SIMActivateRequestDataBase. 

type 


TimeStam 


timeval 


tiinezone 


TimeStam 


5.1.4.3 


declare.vars  dimension  statements 


Table  17  declar.vars  dimension  statements 
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DIS_out_ALPDU_kind 


SIM_PDU_in 


DIS_PDU_out 
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Char  pointer 


Char  pointer 


Char 


DIS.remainder 


DlS.consumed  (initialized  to  0) 


SIM_out_ALPDU_kind 


DIS_PDU_in 


SIM_PDU_out 


DlS_Assoc_LaYer  (  initialized  to  TRUE 


SIM_Assoc_Layer  (  initialized  to  TRUE) 


ass.all  (  initialized  to  TRUE) 


Xlat_DMC  (  initialized  to  TRUE) _ 


ExerciselD 


ProtocoLID 


Battle_Scheme 


loeeer.datafile 


send.infile 


SIMPDU_name  Const  String  array 

[NUMBER_SIM_PDUSHPDU_NAME_NUM_OF_CHA 

RSI 


DISPDU.name  Const  String  array 

CNUMBER_DIS_PDUSI[PDU_NAME.NUM_OF.CHA 

RSI 


DMCPDU_name  Const  String  array 

[NUMBER_DMC_PDUSllPDU_NAME_NUM_OF_CH 

ARS] 


SIMPDU_nuix_delta 


NUMBER SIM PDUS 


DISPDUmax.delta 


Char 


Char  pointer 


Char  pointer 


Char 


Char 


Char 


Char 


Char 


Char 


Char 


File  pointer 


\Eissm!ss3im^\ 


NUMBER_DMC_PDUSI 


SIMPDU.xlates.to  |NUMBER_SIM_PDUS] 


DISPDU_xlates_to  |NUMBER_DIS>PDUS 


PDU_error 

(NUMBER_PDU_ERRORSllPDU_NAME_NUM_OF_C 

HARS1 


terrain.database 


r_asec 


dee_to_rad 


meters_to_feet 


_to_asec 


teet_to_meters 


umber 


GE_DB_oriBin_lat 


Jon 


GE_DB_SW_comerJat 


Const  String  array 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 
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GE_DB_SW_comer_lon 


GE_DB_NE_comer_lat 


GE_DB_NE_comerJon 


lat  ref 


lon_ref 


sw_Iatitude_asec 


sw_loneitude_asec 


coslat 


xoffset 


offset 


Fulda_DB_oriein_lat 


Fuida_DB_oriBin_Ion 


Fulda_DB_SW_comerJat 


FuIda_DB_SW_comer_lon 


Fulda_DB_NE_comer_lat 


FuIda_DB_NE_cort\er_lon 


Iat_ref_fulda 


lonreffulda 


sw_latitude_asec_fulda 


sw Joneitude_asec_fulda 


coslat_fulda 


xoffset_fulda 


offsetfulda 


FGEGCX 


FGEGCY 


FGEGCZ 


FGCGEX 


FGCGEY 


PGCGEZ 


HGEGCX 


HGEGCY 


HGEGCZ 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double  am' 


Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 
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HGCGEX 


HGCGEY 


HGCGEZ 


HUTMGCX 


HUTMGCY 


HUTMGCZ 


hutmecX 


hutmecY 


hutmecXO 


hutmecYO 


hutmecZO 


HGCUTMX 


HGCUTMY 


HGCUTM2 


hecutmX 


hecutmY 


hccutmZ 


hBcutmXO 


hBcutmYO 


hecutm2D 


HUTM84GCX 


HUTM84GC:Y 


HUrM84GC2 


hutn)84ecX 


hutnn84ecY 


hutin84 


hutm84ecXO 


hutin84ecYO 


hutm84ecZO 


HGCUTM84X 


HGCUTM84Y 


HGCUTM84Z 


hecutin84X 


hecutm84Y 


Z 


hEcutin84XO 


hecutin84ZO 


aneular_tolerance 


linear  tolerance 


minimumtimer  value 
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Double 


Double  arra 


Double  arra 


Double  arra 


IDouble 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 

8 

Double 

8 

E)ouble 

8 

IDouble 

8 

Double 

8 

Double 

8 

Double 

8 

Double 

8 

Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Double 


Float 


Float 


Float 
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cease.time 


rebroadcast_tiine 


head 


cvunent 


last 


ID_index 


historv_index 


shmaddr 


shmemptr 
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shmemid 


childpid 


extension 


out_fp 


start.time 


endtime 


old_timel 


old_time2 


old_time3 


old_tifne4 


Netif 


si 


s2 


5.1.5  global.vars.h 

This  header  file  provides  the  data  structures  and  definitions  needed  for 
each  module  that  makes  use  of  global  storage.  This  header  includes  the 
following  header  files  to  maintain  commonality  among  the  various 
functions;  DMC_PDU.h,  decode.defines.h,  decode.strs.h,  decode_list.h,  and 
decode_^rotos.h.  These  header  files,  included  in  this  order,  dimension  and 
define  the  globally  used  structures  and  data  entities. 

5.1.6  decode_defines.h 

This  header  file  defines  the  sizes  of  the  data  structures  used  by  the 
Digital  Message  Communications  Console. 

5.1.6.1.1  decode.defines  structure  Non  specific 


Table  18  decode.defines  structure  Non.spedfic 


1  Item  Name 

lipe 

Description  | 

Header 

Struct 

Gnvnan 

Struct 

DMC_CofnmonBlock_type  I 
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Table  19  decode.defines  define  statements 


Name 


Value 


Description 


FREE_TEXT_WIDTH 


NUMHEADERLINES 


NUM.LINES 


MAX_DMC_UNES 


STRING.SIZE 


NUM.DMC.LOGIC.TYPES 


NUM.DMCSPEEDS 


NUM_DMC_TERM_TYPES 


NUM.DMCPERSON.TYPES 


NUM.DMC.PRIORITY.TYPES 


NUM.DMC.ACTIVITY.TYPES 


NUM.DMCTARGET.TYPES 


NUM_DMC_DIRECTION_TYPES 


NUM.DMC.OBSJNTENTIONS 


NUM.DMC.CLASSIF.TYPES 


NUM_DMC_OBSTACLE_TYPES 


NUM.DMC.BRIDGE.TYPES 


NUM_DMC_BRIDGE_DAMAGE_TYPES 


NUM_DMC_BRIDGE_MATERIAL_TYPES 


NUM_DMC_ACTIVITY  LIKELY.TYPES 


NUM_DMC_MISSION_STATUS_TYPES 


NUM_DMC_MISSION_TYPES 


NUM.DMC.SHELL.TYPES 


NUM_DMC_CONTROL_TYPES 


NUM_DMC_FUZE_TYPES 


NUM.DMC_TRAJECTORY_TYPES 


NUM.DMCDISPOSmONTYPES 


NUM_DMC_CASUALTY_TYPES 


NUM_DMC_COVERAGE_TYPES 


NUM.DMC.TASKTYPES 


NUM.DMC.WHO.TYPES 


NUM_DMC_WHEN_TYPES 


NUM.DMC_FAIL_TYPES 


NUM.DMC_REQ.TYPES 


NUM_DMC_REPORT_TYPES 


NUM_DMC_RECON_TYPES 


NUM_DMC_NBC_DESC_TYPES 


NUM.DMCBURST.TYPES 


NUM_DMC_DELIVERY_TYPES 


NUM_DMC_CLOUD_HGT_TYPES 


width  of  Free  Text  line  in  Free 
Textmessa 


NUM_HEADER.LINES 

NUM.UNES 


direction 


observer  intention 


classification 


obstacle 


bridtze  construction  material 


mission  status 


misnon 


shell 


control 


fuse 


NBC  messaee  enumerations 


burst 


delive 


iBr.g.igpnrmr7 
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NUM_DMC_DESC_TYPES 


NUM_DMC_TYPE_TYPES 


NUM_DMC_VISIBITY_TYPES 


NUM.DMCRESTRICT.-nrPES 


NUM_DMC_CLOUD_TYPES 


NUM_DMC_TURBINT_TYPES 


NUM_DMC_TURBFREQ_TYPES 


NUM_DMC_ICING_INTEN_TYPES 


NUM_DMC_ICING_TYPES 


NUM_DMC_AIRCRAFT_TYPES 


NUM_DMC  AIRCRAFT_STATUS_TYPES 


NUM_DMC_PILOT_STATUS_TYPES 


MSG.UNEO 


MSG.LINEl 


MSG_UNE2 


MSG_UNE3 


MSG_UNE4 


MSG.LINES 


MSG_UNE6 


MSG_UNE7 


MSG.LINES 


MSG_UNE9 


MSG.UNEIO 


MSG.LINEll 


MSG_LINE12 


MSG_UNE13 


MSG.UNEH 


CHAR_STR 


CHAR_STR1 


CHAR_STR2 


CHAR_PRINT 


FREE_TEXT_PER_UNE 
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5.1.7  decode.fprotos.h 

In  C,  function  prototyping  (the  defining  the  input  arguments  and 
resultant  output  from  the  function)  is  required.  The  compiler  will  check  the 
prototyping  of  a  function  against  the  actual  arguments  used  within  the  source 
code  of  the  calling  function  and  flag  as  a  compiler  error  any  incongruities. 
This  header  file  prototypes  all  of  the  functions  used  in  the  decode  portion  of 
theDMC. 

5.1.8  decodejist.h 

This  header  file  provides  the  message  strings  that  are  needed  by  the 
decode  modules.  All  of  these  arrays  are  filled  within  this  header  file  to  be 
indexed  by  the  decode  modules  with  pointers  previously  defined.  Tables 
5.1.8.1  and  5.1.8.2  are  not  defined  for  this  header  ^e. 


Page  402 


E)ocument  ADST/WDL/TR-93-003036 


March  31, 1993 


5. 1.8.3  decode.list  dimension  statements 

Table  20  decode.list  dimension  statements 


Name 


decode.header  label 


decode_ack_label 


decode.freetextvalue 


decode.freetextlabel 


decode.spotlabel 


route 


decode_airroute 


decodebrid 


decode.lzpz 


decode.crossin 


decode_repeat 


decode.cancel 


decode_check 


decode.cno 


decode_shift 


decode_nwinsn 


decodemto 


deccxie.shot 


decode_splash 


decode.eom 


uest 


decode.movond 


decode_status 


decode_nbcl 


decode_nbc4 


decodejnbcS 


decode.dnav 


deccxle.bda 


decode.month 


decode.sub 


decode_recon_variation 


variation 


decode_nbc_variation 


5.1.9  decode.list_proto.h 

This  header  file  prototypes  the  string  arrays  defined  in  decode.listh, 
section  5.1.8,  for  use  by  the  decode  modules. 
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5.1.10  decode.strs.h 

This  header  file  provides  the  string  values  for  'Numerated'*  character 
types  through  the  use  of  pointers,  based  on  sizing  provided  by  define 
statements  in  decode_delines.h,  section  5.1.6.  As  these  are  strings,  diey  are 
variable  in  length.  The  table  will  indicate  the  number  of  elements  in  each 
array.  Tables  5.1.10.1  and  5.1.10.2  are  not  applicable. 


5.1.10.3  decode.strs  dimension  statements 

Table  21  decode.strs  dimension  statements 


1  Name 

Type ! 

Number  | 

inessam_enum_str 

Enumerated  Strinff 

15 

invalid.entry 

Enumerated  StiteR 

1 

loffk_enuin_str 

Enumerated  StttaR 

2 

speedLenumjitr 

Enumerated  StrinR 

2 

tenn_enuin_str 

Enumerated  StrinR 

5 

pefsoi\_enum_str 

Ehumeraled  StrinR 

10 

priority_eniiin_9tr 

Enumerated  StrinR 

3 

tarRet_enunu9tr 

Enumerated  StrinR 

10 

activitv_enuin.str 

Enumerated  StrinR 

11 

diiection_cnum_str 

Enumerated  Strimi 

10 

ob9_int_enu0i_atr 

Enumerated  StrinR 

7 

cla9sifjentun_str 

Enumerated  StrinR 

7 

ob9tacle_enuin_9tr 

Enumerated  Straw 

10 

bridRe_enuin_9tr 

Enumerated  StrirtR 

11 

bridffe_dainaKe_enum_atr 

Enumerated  StrinR 

6 

bridKe_inaterial_enuiiuatr 

Enumerated  Straw 

6 

activitvJikely_enuin_str 

■  1 

5 

inission_status_enum_ftr 

&wmerated  Straw 

5 

iniS8ion_enuin_atr 

Enumerated  Strirw 

5 

sheU_enum_8tr 

Enumerated  Strirw 

7 

contRri_enum_str 

Enumerated  Strirw 

4 

fiize_cnumjBtr 

Enumerated  Strirw 

4 

Emunerated  Straw 

4 

disposition_cnuin_jStr 

Enumerated  Strirw 

3 

casualty_enuin_str 

Enumerated  Strirw 

2 

perceniLCOver_enuin-8tr 

Enumerated  Strirw 

6 

task_enuin_str 

Enumerated  Strirw 

11 

«dv>_enum_8tr 

Enumerated  Strirw 

6 

wdien-cnum-atr 

Enumerated  Strirw 

5 

fail_enuin_str 

Enumerated  Strirw 

10 

lequesfLenumjstr 

Enumerated  Strirw 

2 
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report_enum_str 

Enumerated  Strinft 

7 

recon_aiuin_str 

Enumerated  String 

7 

nbc_desc_enuin_str 

Enumo'ated  SthnR 

10 

burst_onuin_5tr 

6 

delivery  .enum.str 

Enumerated  Strir^ 

7 

cloud_hKt_enum_str 

Enumerated  String 

4 

description_enuin_str 

Enumerated  String 

8 

Enumerated  String 

6 

visibilitv_enuin_str 

Enumerated  String 

8 

restriction_enum_str 

Enumerated  Strii^ 

10 

cloud_enum_str 

5 

turbint_enuin_str 

Enumerated  String 

6 

hirbfreq_enum_str 

5 

iceint_enum_str 

6 

icinK_hj?t_enum_str 

Enumerated  String 

4 

aircraft_enum_str 

13 

aircraft_status_enum_str 

Enumerated  String 

5 

pilot_status_enuin_str 

6 

5.1.11  decode_list_proto.h 

This  header  file  prototypes  the  string  arrays  defined  in 
decode.defines.h,  section  5.1.6,  and  enumerated  in  decode.strs.h,  section 
5.1.10,  for  use  by  the  decode  modules. 


5.1.12  decode_vars.h 

This  header  file  provides  the  data  structures  and  dehnitioits  needed  for 
global  commonality  among  the  modules  that  make  up  the  decode  CSC  of  the 
DMCC.  This  header  includes  the  following  header  files;  DMC_PDU.h, 
decode_defines.h,  decode_strs_proto.h,  decode_list_proto.h,  and 
decode.fprotos.h.  These  header  files,  included  in  this  order,  dimension  and 
define  the  globally  used  structures  and  data  entities. 


5.1.13  DIS_PDU.h 

This  header  contains  the  definitioits  of  the  PDlTs  which  defme 
the  DIS  1.0  protocol,  including  the  PDU’s  which  are  part  of  the 
protocol  extensions.  This  header  hie  implements  the  reqxiirement  for 
entity  ii\formation  and  entity  interaction  protocol  data  uiuts  (PDU’s) 
exchanged  between  simulators  participating  in  a  distributed 
interactive  simulation. 
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5.1.13.1.1  DIS_PDU  structure  Header  type 


Table  22  DIS.PDU  structure  Header.type 


Description 


5.1.13.1.2  DIS.PDU  structure, 


Table  23  DIS_PDU  structure  ActivateRequest.type 


Item  Name 


Description 


Header 


ActivateHostID 


NewEntitvID 


DateTime 


Reason 


Paddin<r3 


TerrainDBaseiD 


Guise 


Unit 


EntitvCapabilities 


SubsystemParameters 


EntityLocation 


Orientation 


DefualtUpdateThresholds 


NumberOfRadarSystems 


NumbetOfShMes 


NumberOfArticulationParam 

eters 


Struct 


Struct 


Struct 


Struct 


Struct 


Struct 


Struct 


Struct 


Struct 


Double 


Struct 


Struct 


Struct 


Char 


Char 


Char 


-  5.1.13.1.1 


RadarSystems.type 
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5.1.13.1.3  DIS.PDU  structure  ActivateResponse  type 


Table  24  DIS.PDU  structure  ActivateResponse.type 


Item  Name 

Type 

Description 

Header 

Struct 

4 

Er\tityID 

Struct 

ID.type 

Timelimit 

2 

ActivateResult 

Char 

1 

PaddinK_3 

Eislism 

3 

-.1 

5.1.13.1.4  DIS.PDU  structure  DeactivateRequest  type 


Table  25  DIS_PDU  structure  DectivateRequest_type 


Item  Name 

Type 

■SOI 

Description 

Header 

Struct 

4 

Header_tvpe  -  5.1.13.1.1 

EntitylD 

Struct 

ID.type 

DeactivateReason 

Char 

1 

PaddinK 

Char 

1 

5.1.13.1.4  DIS.PDU  structure  DeactivateResponse  type 

Table  26  DIS_PDU  structure  DeactivateResposnse.type 


Item  Name 

Type 

Description 

Header 

Struct 

4 

EntitylD 

Struct 

ID.type 

DeactivateResult 

Char 

1 

Padding 

Char 

1 
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5.1.13.1.5  DIS_PDU  structure  CQUisiQIl_t3®fi 

Table  27  DIS_PDU  structure  CoUision_type 


1  Item  Name 

_ 

■3^ 

Description 

Header 

Struct 

4 

IssuinKEntitvID 

Struct 

ID_type 

CoIIidinKEntitylD 

Struct 

ID_type 

EventID 

Struct 

1  :r7Til  1 1 

PaddinK_2 

2 

TimeStamp 

Struct 

TimeStamp.type 

Velocity 

Struct 

LinearVelocitv.type 

Mass 

Float 

4 

Location 

Struct 

5.1.13.1.6  DIS.PDU  structure  Detonation  type 

Table  28  DIS_PDU  structure  Collision_tyi>e 


Item  Name 

IZE« 

Description  | 

Header 

Struct 

4 

FirinREntitylD 

Struct 

ID_type 

TarKetEntitylD 

Struct 

ID_type 

MunitionID 

Struct 

ID_type 

EventID 

Struct 

1  -i'i'gi  t 

TimeStamp 

Struct 

TimeStamp.type  I 

Location 

Struct 

BurstLocation 

Struct 

BurstLocation_type 

Velocity 

Struct 

LinearVelocity_type 

Impact 

Struct 

DetortadonResult 

Char 

1 

NumberOfArticulatioitParam 

eters 

Char 

1 

PaddinK 

tei.M#.liaM 

6 

ArticulationParameters 

Array  of 

Struct 

Articulation.type 

I 
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5.1.13.1.7  DIS_PDU  structure 


March  31, 1993 


Table  29  DIS.PDU  structure  Emitter.Type 


Item  Name 


TimeStam 


EntitvLocation 


EntitvOrientation 


DeadReckoninsParameters 


NumberOfEmitters 


DatabaseNumber 


Emitter 


Array  of 
Struct 


5.1.13.1.8  DIS_PDU  structure 


Table  30  DIS^PDU  structure  EntityState_type 


I 

I 
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5.1.13.1.9  PIS  PDU  structure  Fire  type 


Table  31  DIS_PDU  structure  Fire_type 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


I 

I 


I 

I 


5.1.13.1.12  DIS_PDU  structure  RepairResponse  type 


Table  34  DIS_PDU  structure  ReparirResponse.tyjje 


1  Item  Name 

_ 

likisJ 

Description  | 

HHH 

Header 

Struct 

4 

RequestinKEntitylD 

Struct 

ID_tvpe 

ServicinKEntitylD 

Struct 

ID-type 

RepairResult 

Char 

1 

PaddinK_3 

3 

5.1.13.1.13  DIS_PDU  structure  Resupply  type 

Table  35  DIS_PDU  structure  Resupply _type 


Item  Name 

_  Type 

Description 

Header 

Struct 

4 

RequestinsEntitylD 

Struct 

ID_type 

ServicinKEntitylD 

Struct 

ID_type 

NumberOtSupplyTypes 

Char 

1 

PaddintL.3 

3 

Supply 

Array  of 

Struct 

Supply.type 

5.1.13.1.14  DIS_PDU  structure  ResupplyCancel  type 


Table  36  DIS_PDU  structure  ResupplyCancel_type 


Item  Name 

Jm 

CSS 

Description 

IHHHHI 

■■■ 

Header 

Struct 

4 

RequestinKEntitylD 

Struct 

ID_type 

ServicinKEntitylD 

Struct 

ID_type 
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5.1.13.1.15  PIS  PDU  strugture  ServiceRequest  type 

Table  37  DIS_PDU  structure  ServiceRequest.type 


1  Item  Name 

Iyp« 

Description  | 

IHHHHH 

Em 

Header 

Struct 

4 

ReguestinsEntitylD 

Struct 

ID-type 

ServiciriKEntitylD 

Struct 

ID-type 

ServiceTvpe 

Char 

1 

Char 

1 

PaddinK_2 

Inteeer 

2 

Supply 

Array  of 

Struct 

Supply.type 

5.1.13.1.16  DIS.PDU  structure  UpdateThresholdReguest  type 

Table  38  DIS.PDU  structure  UpdateThresholdRequest.type 


1  Item  Name 

I5:e« 

Description  | 

iehhhh 

Header 

Struct 

4 

RequestorEntitylD 

Struct 

ID-type 

ResponderEntitylD 

Struct 

ID_type 

LinearThreshold 

Struct 

RotationalThreshold 

Struct 

DuradoitOfChanKe 

Intejter 

4 

5.1.13.1.17  DIS.PDU  structure  UpdateThresholdResponse  type 

Table  39  DIS_PDU  structure  UpdateThresholdResponse_type 


1  Item  Name 

lipe 

Description 

MHHHHIHHHHii 

Header 

Struct 

4 

umng^r^sssssmmm 

RequestorEiititylD 

Struct 

ID.type 

Struct 

ID_type 

Result 

Char 

1 

RemaininaTime 

Char 

1 

PaddinK_2 

iijsss _ 

2 
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5.1.14  DIS_typ€S.h 

This  header  file  contains  definitions  of  various  basic  data  elements, 
including  how  these  elements  are  represented  as  commuxucated  bits.  The 
elements  compose  the  fields  which  compose  each  PDU. 


5.1.14.1.1  DIS.types  structure  Land 


Table  40  DlS^types  structure  Land 


Item  Name 

Type 

Description 

Unused 

Long 

4 

Hatch 

Long 

4 

Engine.smoke 

Long 

4 

Launcher 

Long 

4 

Paint_scheme 

Long 

4 

Dust_cloud 

Long 

4 

Flaming 

Long 

4 

Smoke_plume 

Long 

4 

Destroyed 

Long 

4 

5.1.14.1.2  DIS_types  structure  Ail 

Table  41  DIS.types  structure  Land 


Item  Name 

Type 

1313 

Description 

Unused 

Long 

4 

Formation.lights 

Long 

4 

N  avigation.lights 

Long 

4 

Running_lights 

Long 

4 

After_burner 

Long 

4 

Flaming 

Long 

4 

Destroyed 

Long 

4 
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March  31, 1993 


Table  42  DIS.types  structure  Surface 


Item  Name 


Unused 


Running_lights 


Wake 


Flamin 


Destroyed 


5.1.14.1.4  DIS.types  structure  Subsurface 


Table  43  DIS.types  structure  Subsurface 


Item  Name 


Unused 


Hatch 


Ruiming^lights 


Wake 


Destroyed 


5.1.14.15  DIS.types  structure  Sl2a££ 


Table  44  DlS_types  structure  Space 


Item  Name 

Type 

Description 

Unused 

Long 

4 

Destroyed 

Long 

4 

Page  414 


Document  ADST/WDL/TR--93-003036  March  31, 

5.1.14.1.6  PIS  types  structure  GuidedMunitions 


Table  45  DIS.types  structure  GuidedMurutions 


Item  Name 

Type 

Description 

Unused 

Long 

4 

Rocket_flame 

Long 

4 

Launch.flash 

Long 

4 

5.1.14.1.7  DIS_types  structure  Lifeforms 


Table  46  DIS.types  structure  Lifeforms 


Item  Name 


Unused 


Weapon_l 


Weapon_2 


Lifeform_state 


Description 


5.1.14.1.8  DIS_types  structure 


Table  47  DIS_types  structure 


Item  Name 


Unused 


Damaee 


5.1.14.1.9  DIS.types  structure 


Table  48  DIS.types  structure 


Item  Name 


Unused 


Flamin 


Smoke.plume 


Damaee 


Document  ADST/WDL/TR-93-003036 
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5.1.14.1.10  DIS.types  structure  ID  typ* 


Table  49  DlS.types  structure  ID  type 


5.1.14.1.11  DIS.types  structure 


Table  50  DIS.types  structure 


5.1.14.1.12  DIS.types  structure  Entity  type 


I 

I 
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5.1.14.1.18  DIS.types  structure  AnyularVelnr 
Table  56  DlS.types  structure  Al 


Pm _ 

Theta 

Phi 


Item  Name 


Type 


bytes 


Integer 

Integer 


4 

4 

4 


5.1.14.1.19  DB.types  structure  FloatAngles 
Table  57  DIS.types  structure  ] 


Pa _ 

Theta 

Phi 


Item  Name 


Type 


bytes 


Hoat 

Float 

Float 


4 

4 

4 


5.1.14.1.20  PIS  types  structure  LinearVelodr 
Table  58  DIS.types  structure  ] 


Item  Name 


JXSL 


bytes 


Float 


Float 


Float 


5.1.14.1.21  DlS.types  structure  QrientatlPn  t; 

Table  59  DIS_types  structure  j 


bytes 


Item  Name 


Type 


Psi 


Long 


Theta 


Long 


Phi 


Long 
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5.1.14.1.22  DIS_types  structure  DeadReckor 
Table  60  DIS.types  structure . 


Item  Name 
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5.1.14.1.25  DIS.types  structure  BurstPescr 
Table  63  DIS_types  structure . 


Item  Name 


Munition 


Warhead 


Fuze 


Quani 


Rate 


5.1.14.1.26  DIS.types  structure  Army 

Table  64  DB.types  structure  Army 


Item  Name 


Army.Number 

Char 

Corps_Number 

Char 

Division.Number 

Char 

ReKiment.Number 

Char 

Battalion.Number 

Char 

Company_Number 

Char 

Platoon_Number 

Char 

Squad.Number 

Char 

5.1.14.1.27  DIS.types  structure  AirForce 

Table  65  DIS.types  structure  AirForce 


Item  Name 


Description 


AirForce  Number 


Wine  Number 


Squadron.Number 


Flieht_Number 


Division.Number 


Section_Number 


Spare 


Char 


Char 


Char 


Char 
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5.1.14.1.28  PIS  types  structure  CoastGuard 


Table  66  DIS.types  structure  CoastGuard 


Item  Name 

Type 

Description 

Spare 

8 

5.1.14.1.29  PIS  types  structure  Marines 

Table  67  DIS.types  structure  Marines 


_ Item  Name 

Fleet.Number 

Force.Number 

Brigade.Number 

Unit.Number 

Spare 


Char 

Char 


Char 


Char 


5.1.14.1.30  DIS.types  structure  Navy 


Table  68  DIS.types  structure  Navy 


Item  Name 

Type 

Description 

Fleet.Number 

Char 

1 

Force.Number 

Char 

1 

Group.Number 

Char 

1 

Unit.Number 

Char 

1 

Element.Number 

Char 

1 

Spare 

3 
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5.1.14.1.31  DIS_types  structure  Unit  type 


Table  69  DIS.types  struc 


Item  Name 

Type 

ISO! 

Force 

thu 

1 

Coimtry 

2 

Service 

Char 

1 

Hierarchy 

8 

5.1.14.1.32  DIS.types  structure  EntityCapab: 

Table  70  DIS.types  structure  £] 


Item  Name 

Type 

Unused 

Long 

4 

Repair 

Long 

4 

MiscellaneousSupply 

Long 

4 

FuelSupply 

Long 

4 

AmmunitionSupply 

Long 

4 

5.1.14.133  DIS.types  structure  RadarSysten 
Table  71  DIS.types  structure 


Item  Name 

Type 

Category 

Char 

1 

Subcategory 

Char 

1 

RadarSystemID 

2 
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5.1.14.1.34  DIS.types  structure  Illumined  type 

Table  72  DIS.types  structure  Tllnmined  type 


Item  Name  I  Type  I  bytes  I  Description 


Lon 


TarzetlD 


Padding_2 


RadarData 


5.1.14.1.35  DIS_types  structure  Sweep  type 

Table  73  DIS_types  structure 


Item  Name  Type  bytes  Description 


AzimuthCenter 

Lon 

AzimuthWidth 

Lon 

EleyationCenter 

Lon 

Elevation  Width 

Lon 

5.1.14.1.36  DIS_typ€s  structure  Emitters  T} 
Table  74  DlS^types  structure 


Item  Name 


Class 


ModeNumber 


DBaseEntryNumber 


5.1.14.1.37  DIS.types  structure  Emitters  Dz 
Table  75  DIS.tjrpes  structure 


Item  Name 


Power 


ParameterNumberl 


ParameterNumber2 


ParameterNumber3 
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5.1.14.1.38  DIS.types  structure  Emitters  type 
Table  76  DIS_types  structure , 


Item  Name 


Type 


Parameters 


Swee 


Description 


Struct 


Struct 


Struct 


Emitters_Type_type  - 
5.1.14.136 


Emitters_Data_type  - 
5.1.14.137 


Sweep_type  -  5.1.14.1.35 


5.1.14.1.39  DIS.types  structure  RadarBasePi 
Table  77  DIS.types  structure 


Item  Name 


Description 


truct 


Struct 


Location 


RadarSystem 


Power 


RadarMode 


NumberOfllluminated  Char 


SpecificData 


Sweep  Struct 


Swee 


-  5.1.14.1.35 


5.1.14.1.40  DK  types  structure  RadarArray  type 
Table  78  DIS_types  structure , 


Item  Name 


Description 


RadarSystemData 

Struct 

Illumined 

Array  of 
Struct 

Illumined_type 
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5.1.14.1.41  DIS_types  Structure ! 


March  31, 1993 


Table  79  DIS_types  structure ; 


Item  Name 


value 


reference 


5.1.14.2  DIS.types  define  statements 


Table  80  DlS.types  define  statements 


Name 


Value 


Descriotion 


LIFEFORM_STATE_DESTROYED 


LIFEFORM_STATE_UPRIGHT 


LIFEFORM.STATEICNEEUNG 


LIFEFORM_STATE_PRONE 


PASS_ALL_ID_CODE 


IGONRE_ALL_ID  CODE 


ENnTY_ID  SIZE 


OTHER  KIND 


PLATFORM_KIND 


MUNITION  KIND 


LIFE.FORMKIND 


ENVIRONMENTAL_KIND 


CULTURAL  FEATURE  KIND 


SUPPLIES  KIND 


LAND.DOMAIN 


AIR  DOMAIN 


SURFACE  DOMAIN 


SUBSURFACE_DOMAIN 


SPACE.DOMAIN 


TANK 


ARMORED_FIGHTING_VEH 


ARMORED  UTILITY  VEH 


SELF_PROPELLED_ARTILLERY 


TOWED  ARTILLERY 


SMALL_WHEELED_UTILITY_VEH 


LARGE  WHEELED_UTILmr_VEH 


SMALL_TRACKED_UTE-rrY_VEH 


LARGE_TRACKED_UTILITY_VEH 


DISMORTAR 


AMPHIBIOUS_ASSAULT_VEH 


MISC_WEAPONS  SYSTEMS 


DIS  Ml  TANK 


0 


1 


2 


3 


OxFFFF 


0 


6 


0 


1 


2 


3 
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PIS  M60  TANK _  12 


PIS  MSSl  TANK _ 13 


PIS  M48  TANK 


PIS  IFV  AFV _  I  1 


PIS  M2  AFV _  13 


PIS  M3  AFV 


PIS  Ml  13  AFV _  IS 


PIS  HUMMV  SWUV _  Tl 


PIS  M577_SWUV _ 12 


PIS  FAV  SWUV _ 13 


PIS  M352  LWUV _ ll 


PIS  M977  LWUV _ 12 


PIS  M978  LWUV _ |3 


PIS  M548_LTUV  _ Ll 


PIS  MLRS  SPA  _ ll 


PIS  Ml  10  SPA  _  12 


PIS  M109  SPA  _  13 


PIS  GLCM  LAUNCHER  SPA 


PIS  M198  15SMM  TOWEP  ART  I  2 


PIS  MS7  TOWEP  ART _  111 


PIS  M128  GEMSS  TOWEP  ART  I  12 


PIS  M58A1  TOWEP  ART _  1 14 


PIS  M88  AUV _ _ _  I  1 


PIS  M578  AUV  _  12 


PIS  M29  MORTAR  _  I  1 


PIS  M224  MORTAR  _  12 


PIS  MK19  GRENAPE  LAUNCHER  1 2 


PIS  VULCAN  APS  SAM _  I  3 


PIS  M113A2  MOPEL  _  I  1 


PIS  M88A1  MOPEL _ ll 


PIS  M3S2  MOPEL _ Ll 


PIS  M352A2  MOPEL _ Ll 


PIS_USSR_T80  TANK _ Ll 


PIS  USSR  T72M  TANK _ Ll 


PIS  USSR  T64  TANK _ U 


PIS  USSR  T62  TANK 


PIS  USSR  TS4  TANK _ Ll 


PIS  USSR  T55  TANK _ Ll 


PIS  USSR  TIP  TANK 


PIS  USSR  PT76  TANK  _ 18 


PIS  USSR  P20  TOWEP  ART _ Ll 


PIS  USSR  D30  I22MM  TOWED  ART 


PIS  USSR  D30FIELD  TOWED  ART _ Ll 


PIS  USSR  M1965  TOWED  ART _ I  10 


PIS  USSR  M1943_  MORTAR _ Ll 


PIS  USSR  M19S2  MORTAR 


PIS  USSR  SS12  SPA _ 111 


PIS  USSR  BM21  MRLS  SPA _ 1 13 


PIS  USSR  BM24  MRLS  SPA 
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DIS  USSR  BMPl  AFV 


DIS  USSR  BMP2  AFV 


DIS  USSR  BRDMIAFV 


DIS  USSR  BRDM2  AFV 


DIS  USSR  BTR40  AFV 


DIS  USSR  BTR153  AFV 


DIS_USSR  BTR60_70  AFV 


DIS_USSR_ACRV_AFV 


DIS^USSR  BTS2_AUV 


DIS  USSR  MTP  AUV 


DIS  USSR  IMR2_AUV 


DIS_USSR  IPR.AUV  _ 


DIS_USSR  MAV  SWUV 


DIS_USSR  GAZ63_LWUV 


DIS_USSR  GA266  LWUV 


DIS.USSR  URAL375  LWUV 


DIS_USSR  FROG5_SSML 


DIS  USSR  FROG7_SSML 


DIS  USSR  SCUDB  SSML 


DIS_USSR_PTS_XPORT_LTUV 


USSR  BMP1K_AFV_M0DEL 


USSR  T72  TANK.MODEL 


USSR  T72M  TANK  MODEL 


HGHTER 


ATTACK 


DIS_BOMBER 


CARGO 


ANTI  SUBMARINE 


PATOL 


ATTACK  HELICOPTER 


UTILITY  HELICOPTER 


CARGO  HEUCOPTER 


OBSERVATION  HEUCOPTER 


SEA  GOING.HELICOPTER 


ELECTRONIC  WARFARE 


DIS_A4  ATTACK 


DIS  A7  ATTACK 


DIS  AIO  ATTACK 


DIS  FI  17  STEALTH 


DIS  F14  HGHTER 


DIS_F16  HGHTER 


DIS  FB  111  HGHTER 


DIS  F4S  HGHTER 


DIS  FISHGHTER 


DIS_FA  18  HGHTER 


DIS_F5F  HGHTER 


DIS  BS2  BOMBER 


DIS  C130_CARGO 


DIS  CS  CARGO 


!□ 

ID 

ID 


in 

IB 

la 


March  31, 1993 


Page  427 


Document  ADST/WDL/TR~93-003036 


CIS_C141_CARGO 


PIS  P3  PATROL _ 


PIS  PIONEER_RPV_PATROL 


PIS  E2  ELEC  WARFARE 


PIS  MODEL_F14A 


PIS  MOPEL_F14D _ 


PIS  AH64  COPTER 


PIS  AHICOPTER 


PIS  OH58  COPTER 


PIS  OH58C_COPTER 


PIS  OHS8P  COPTER 


PIS  UHICOPTER 


PIS  UH60_COPTro _ 


PIS  CH47_COPTER _ 


PIS  CH53  COPTER 


PIS  MIG31  RGHTER 


PIS  MIG29  HGHTER 


PIS  SU27_FIGHTER 


PIS  MIG25_FIGHTER 


PIS_MIG23_FIGHTER 


PIS  MIG21  HGHTER 


PIS  MIG27  ATTACK 


PIS  SU25_ATTACK 


PIS_YAK36  ATTACK 


PIS  TU16  BOMBER 


PIS  TU26  BOMBER 


DIS_TU22_BOMBER 


PIS  TU142_BOMBER 


DIS_TU126_PATROL 


PIS  AN124  CARGO 


PIS  AN22  CARGO 


PIS  1176  CARGO 


PIS  MI28  COPTER 


PIS  MI24  COPTER 


PIS  KA136_COPTER 


PIS  MI8  COPTER 


PIS  MII4  COPTER  _ 


OIS_MI26_COPTER 


OIS_MI6  COPTER 


OIS_MI2_COPTER 


OOS_MIRAGE_Fl_HGHrER 


PIS  SA342_GAZELLE 


PIS  UK  CfflEFTAIN  TANK 


CARRIER 


COMMANP  SHIP 


GUIPEP_MISSLE_CRUISER 


GUIPEP_MISSLE_PESTROYER 


PESTROYER 


GUIPEP_MISSLE_FRIGATE 


!□ 

IB 

IB 
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PATROLCRAFT  _ 


MINE  COUNTERMEASURE 


DOCK  LANDING  SHIP 


TANK  LANDING  SfflP 


LANDINGjCRAFT 


FRIGATE 


BATTLESHIP 


HEAVY_CRUISER 


DESTROYER_TENDER 


AMPHIBIOUS_ASSAULT_SHIP 


AMPHIBIOUS  CARGO_SHIP 


AMPHIBIOUS  TRANSPORT_DOCK 


AMMUNITI0N_SHIP _ 


COMBAT_STORES_SHIP 


DIS  USS  TAWARA  CLASS 


DIS  USS  IWO  JIMA  CLASS 


DIS  USS.WASP  CLASS 


DIS_USS_CHARLESTON_CLASS 


DIS  USS  AUSTIN_CLASS 


DIS  USS_RALIEGH  CLASS 


DIS_USS_WHIDBEY  ISLANE  CLASS 


DIS_USS_ANCHORAGE_CLASS 


DIS  USS  THOMASTON  CLASS 


DIS  USS_NEWPORT  CLASS 


DISUSSJDESOTO  COUNTYCLASS 


DIS_USS_LCAC_CLASS 


DIS_USS_NIMITZ  CLASS 


DIS  USS  ENTERPRISE  CLASS 


DIS  USS_KnTYHAWK  CLASS 


DIS_USS_FORRESTALjCLASS 


DIS  USS  MIDWAY  CLASS 


DISUSS  BLUERIDGE_CLASS 


DIS_MISC_CONVERT_CMD_SHIPS 


DIS  USS_TICONDEROGA_CLASS 


DIS  USS  VIRGINIA  CLASS 


DISUSSCALIFORNIACLASS 


DIS  USS  TRUXTUN  CLASS 


DIS  USS  BELKNAP_CLASS 


DIS  USS_BAINBRIDGE_CLASS 


DIS_USS_LEAHY_CLASS 


DIS_USS_ALBANY_CLASS 


DISUSSLONGBEACH  CLASS 


DIS_USS_ARLEIGHBURKE  CLASS 


DISUSS  KIDD_CLASS 


DIS  USS  FARRAGUTCLASS 


DIS_USS_CHARLESFADAMS_CLASS 


DIS_USS_SPRUANCE_CLASS 


DIS  USS  OHPERRY  CLASS 


DIS  USS  BROOKE  CLASS 
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PIS  USS  PEGASUS  CLASS _ Li 


PIS  USS  HIGHPOINT  CLASS _ 12 


PIS  USS  MM  SPEC  WARFARE  CLASS  I  3 


PIS  USS  KNOX  CLASS  _  IT 


PIS  USS  GARCIA  CLASS  I  2 


PIS  USS  BFONSTEIN  CLASS  I  3 


PIS  USS  IOWA  CLASS  _  I  1 


PIS  USS  PESMOINES  CLASS _  IT 


PIS  USS  SAM  COMPEL  CLASS _ JT 


CLASS _ U 


PIS  USS  KILAUEA  CLASS _ Li 


PIS  USS  MARS  CLASS _ 12 


PIS  PP  964  PAULFFOSTER _ |l 


PIS  PP  963  SPRUANCE _ [2 


PIS  PP  976  MERRILL  _ I  14 


PIS  PP  978  STUMP _ I  16 


PIS  PPG  37  FARRAGUT _ Ll 


PIS  PPG  39  MACPONOUGH _ [3 


PIS  PPG  40  COONTZ 


PIS  CG47  TICONPEROGA _  1 1 


PIS  CG48  YORKTOWN _  12 


PIS  CGIO  ALBANY  _  IT 


PIS  PCH  1 _  I  I 


PIS  PBMT _ _ _  IT 


PIS  CA134  PESMOINES  _  iT 


PIS  FF1037  BRONSTEIN _  I  I 


PIS  LCAC  I  1 


PIS  TAE26  KILAUEA  1 1 


PIS  TAFS8  SIRIUS  1 1 


PIS  AFSl  MARS _  1 1 


nis  Arvtl  YF1.LOWSTONE _ ll 


PIS  AP42  ACAPIA 


PIS  APIS  PRAIRIE _ Ll 


MCM  MSH  TYPE _ Li 


MCM  AVENGER  CLASS _ |2 


MCM  ACME  CLASS _ U 


MCM  Ar.n.F,  AGRESS  CLASS 


MSM  I  AVENGER _ Ll 


MSM  509  APROIT _ Ll 


MSM  427  CONSTANT _  I  1 


STRATEGIC  MISSLE  SUB _ ll 


ATTACK  SUB 


RESEARCH  SUB _ 1 50 


PIS  USS  OHIO  CLASS _ Ll 


PIS  USS  BEN  FRANKLIN  CLASS  I  2 


PIS  USS  LOS  ANGFI  RS  CLASS  I  1 


PIS  USS  STURGEON  CLASS 


PIS  USS  SKIPJACK  CLASS 


PIS  USS  BARBEL  CLASS _  |g 
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PIS  USS  TRITON  CLASS _ 

FRANKLIN  CLASS  OFFSET _ 

PIS  USS  DOLPHIN  CLASS _ 

PIS  SSBN  616  LAFAYETTE _ 

PIS  SSN  585  SKIPJACK _ 

PIS  SSN  590  SCULPIN _ 

PIS  SSN  590  SNOOK _ 

PIS  SSN  586  TRITON _ 

PIS  AGSS  555  DOLPmN _ 

MANNED  SPACE  PLATFORM _ 

UNMANNED  SPACE  PLATFORM _ 

SATELLITE  USP _ 

SPACE  SHUTTLE  MSP _ 

SPACE  STATION  MSP _ 

GUIDED  MUNITIONS _ 

BALUSTIC  MUNITIONS _ 

nXED  MUNITIONS _ 

BOMB  MUNITIONS _ 

FUZE  MUNITIONS _ 

PIS  _TMD_B _ 

PIS  YAM  5 _ 

PIS  TM  46 _ 

PIS  TMN  46 _ 

PIS  TM  57 _ 

PIS  TM  62M _ 

PIS  TMK  2 _ 

PIS  POMZ  2 _ 

PIS  OMZ  3 _ 

PIS  MON _ 

PIS  PMN _ 

PIS  PMK  40 _ 

ANTI  AIR  DOMAIN _ 

ANTI  ARMOR  DOMAIN _ 

ANTI  GUIDED  MUNITION  DOMAIN 

ANTI  RADAR  DOMAIN _ 

ANTI  SATH-I-ITF  DOMAIN _ 

ANTI  SHIP  DOMAIN _ 

ANTI  SUBMARINE  DOMAIN _ 

BATTLEFIELD  SUPPORT  DOMAIN 
STRATEGIC  DOMAIN 
MISCEI.LANEOUS  MUNITIONS  DOMAIN 

ANTI  PERSONNEL _ 

ANTI  ARMOR _ 

BATTLEFTFr  n  SUPPORT _ 

PIS  SIDEWINDER _ 

PIS  ADATS _ 

PIS  STINGER _ 

TOMAHAWK  AGM  109 _ 

TOMAHAWK  BGM  I09G _ 


0 

9 


5 


2 


2 

T 

1 

T 

1 

7 

T 

1 

7 

7 

T 

7 

9 

10 

ji. 

11 
11 
14 
1 

2 

7 

4 

7 

7 

7 

9_ 

11 

2_ 

2_ 

3_ 

6 
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DIS  GREMLIN 

I 

TOW  MISSLE 

1 

M47  DRAGON 

2 

DIS  SWATTER 

4 

DIS  SPANDREL 

7 

DIS  SPIRAL 

8 

DIS  SONGSTER 

10 

DIS  STYX 

8 

LAND  UFEFORM 

1 

DIS  OTHER  INFANTRY 

QHlHi 

DIS  DISMOUNTED  INFANTRY 

1 

NUM  TEAM 

101 

NUM  SOUAD 

m 

NUM  PLATOON 

103 

NUM  COMPANY 

104 

NUM  BATTALION 

105 

NUM  REGIMENT 

106 

NUM  DIVISION 

107 

NUM  CORPS 

108 

NUM  ARMY 

109 

DIS  M72  LAW 

4 

DIS  M60  GPMG 

6 

DIS  RPG7  VAT  ROCKET  LAUNCHER 

4 

DIS  AA52  MG 

6 

BRIDGE  CONCRETE  TWO  LANE 

1 

BRIDGE  CONCRETE  POUR  LANE 

2 

BRIDGE  TRUSS  TWO  LANE 

3 

BRIDGE  TRUSS  FOUR  LANE 

BRIDGE  SUSPENSION  TWO  LANE 

5 

BRIDGE  SUSPENSION  FOUR  LANE 

6 

BUILDING  ONE  STORY 

7 

BUILDING  TWO  STORY 

8 

BUILDING  THREE  STORY 

9 

BUILDING  FOUR  STORY 

10 

MINEFIELD  MARKERS 

17 

BREACHED  LANE  FLAGS 

18 

SIZE  VERY  SMALL 

20 

SIZE  SMALL 

40 

SIZE  MEDIUM 

60 

SIZE  LARGE 

80 

SIZE  VERY  LARGE 

100 

FUELS 

1 

OILS 

2 

LUBRICANTS 

3 

FXD 

4 

SPARE  PARTS 

5 

PERSONNEL 

6 

DIS  PROPELLANT 

7 

DIS  CONSTRUCTION 

8 
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PIS  AMMO 


PIS  PERSONAL  DEMAND _  |9 


PIS  MAJOR  END  ITEMS _  I  10 


PIS  MEDICAL  MATERIAL _  I  11 


GASOLINE  _  I  1 


DIESEL  FUEL  I  2 


JP4  FULE _ 


FUEL  OIL 


PIS  BAGGED  PROPFI 1  ANT _  ll 


PIS  CANNISTERED  PRQPFI  l  ANT  \7 


PIS  AIR  DEFENSE  AMMO _ ll 


PIS  AR  FORCE  AMMO _  12 


PIS  ARMY  AVIATION  AMMO _ 13 


PIS  ARTILLERY  AMMO 


PIS  CHEMICAL  AMMO _  15 


PIS  MINES  AND  EXPLOSIVES 


PIS  NUCLEAR  AMMO 


PIS  ROCKET  ARTn  iJq?Y  AMMO  I  8 


PIS  SMALL  ARMS  AMMO _ 19 


PIS  TANK  AMMO  I  10 


PIS  COUNTRY  OTHER 


PIS  COUNTRY  FRANCE  I  55 


PIS  COUNTRY  GERMANY  I  57 


PIS  COUNTRY  USSR  1 164 


PIS  COUNTRY  UK _ _ _  1166 


PIS  COUNTRY  USA  I  168 


GUISE  SIZE  18 


SUPPLY  SIZE _  1 12 


DRM  OTHER _  lO 


DRM  STATIC  _  Tl 


DRM  FPW _ 12 


DRM  RPW  _  |3 


PRMRVW 


DRM  FVW _ _ 15 


DRM  FPB _ 16 


DRM  RPB 


DRM  RVB 


DRM  FVB _ |9 


UNUSED  DR  BYTES _ 1 15 


ARTICULATION  SIZE _ _ 1 16 


NO  ART  CHANGE 


DIRECTLY  ATTACHED _  tO 


INDIRECTLY  ATTACHED _ ll 


PARAM  TYPE  ENffTY  _ lO 


PARAM  TYPE  POSITION _ Ll 


PARAM  TYPE  POSITION  RATE _ \2 


PARAM  TYPE  EXTENSION _ U 


PARAM  TYPE  EXTENSION  RATE 


PARAM  TYPE  LOCATION  X _ [5 
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PARAM_TYPE  LOCATION  X  RATE 


PARAM  TYPE  LOCATION  Y  _ 


PARAM_TYPE_LOCATION_Y_RATE 


PARAM  TYPE  LOCATION  Z 


PARAM_TYPE_LOCATION_Z_RATE 


PARAM  TYPE_AZIMUTH 


PARAM  TYPE_AZIMUTH_RATE 


PARAM  TYPE  ELEVATION 


PARAM  TYPE_ELEVATION_RATE 


PARAM  TYPE.ROTATION 


PARAM  TYPE  ROTATION  RATE 


PARAM  TYPE  ACCELERATION_X 


PARAM  TYPE  ACCELERATION  Y 


PARAM  TYPE  ACCELERATION  Z 


NUM  PARAM  TYPES  _ 


STATION.RUDDER  _ 


STATIONLEFT  WING  _ 


STATION_RIGHT_WING 


STATION_LEFT_AILERON 


STATION_RIGHT_AILERON 


STATION  PERISCOPE 


STATION  ANTENNA 


STATIONSNORKEL 


STATION_LANDING_GEAR 


STATION  TAIL  HOOK 


STATION  SPEED_BRAKE 


STATION  LEFT.WEAPON  BAY_DOOR 


STATION_RIGHT_WEAPON_BAY_DOOR 


STATION  HATCH 


STATION  WINGSWEEP 


STATION  PRIMARY_TURRET 


STATION  PRIMARY.GUN 


STATIONPRIMARYLAUNCHER 


STATION  PRIMARY.DEFENSE 


STATION  PRIMARYRADAR 


STATION  SECONDARY.TURRET 


STATION  SECONDARY  GUN _ 


STATION_SECONDARY_LAUNCHER 


STATION  SECONDARY_DEFENSE 


STATION_SECONDARY_RADAR 


MAX  ENTITY  MARKING_LENGTH 


CHARACTER_SET_UNUSED 


CHARACTER  SET^ASCn 


MAX_DBASE_ID_LENGTH 


WARHD.OTHER 


PLASTIC 


WARHD_HE_INCENDIARY 


WARHD  HE  FRAGMENTAION 
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_ANTI  TANK _ 


BOMBLETS _ 


_SHAPED  CHARGE 


WARHD_SMOKE 


WARHD  ILLUMINATION 


WARHD_PRACTICE 


WARHD  KINETIC 


WARHD  UNUSED 


WARHD  NUCLEAR 


WARHD  CHEMICAL 


WARHD  CHEMICAL  BUSTER 


WARHD  CHEMICAL  BLOOD 


WARHD  CHEMICAL_NERVE 


WARHD  BIOLOGICAL 


FUZE  OTHER 


FUZE  CONTACT 


FUZE  CONTACT.INSTANT 


FUZE  CONTACT_DELAYED 


FUZE_TIMED 


FUZE.PROXIMITY 


FUZE  COMMAND 


FUZE  ALTITUDE 


FUZE_DEPTH 


FUZEACOUSnC 


OTHER  FORCES 


BLUE  FORCES 


WHITE  FORCES 


OTHER_SERVICE 


ARMY  SERVICE 


AIR  FORCE_SERVICE 


COAST  GUARD.SERVICE 


MARINES_SERVICE 


NAVY.SERVICE 


RADAR  SYSTEM_SIZE 


categorv_shift 


RESERVED_CATEGORY 


CONTROL 


AIR  BASED  SEARCH 


CONTROL 


GROUND_BASED_SEARCH 


CONTROL 


SEA  BASED  SEARCH 


RADAR  MODE  OFF 


SEARCH 


DOPLER  HPRF 


DOPPLER_MPRF 


DOPPLER.LPRF 


MONOPULSE 


1400 


1500 


1600 


2000 
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ACOUISmON 


TRACKING _ 


TRACK  WHILE  SCAN 


TERRAIN_FOLLOW 


DATALINK 


MAX  ILLUMINED 


RELATIVE  TIME 


ABSOLUTE  TIME 
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5.1.15  DMC_PDU.h 

This  header  file  contains  definitions  of  the  PDUs  which  define  an 
extension  of  the  DIS  1.0  protocol,  called  die  EMgital  Message  Communication. 


5.1.15.1.1  DIS_types  structure  PMC  C( 
Table  81  DIS.types  structure . 


Item  Name 


SenderlD 


RadioID 


ExerciseTime 


UDused.15 


TimesForwarded 


SenderTerminal 


SnederPerson 


Altitude 


TareetlD 


TareetTerminal 


TareetPerson 


Struct 


Inteser 


Inteser 


Char  array 


Char 


Char 


Char 


Inteser 


Struct 


Char 


Char 


15  I  SIM_UNUSED.ARRAY_SI 


SenderCEOI 

8 

based  on  CEOI  LENG 

LastFwdCEOI 

8 

based  on  CEOI  LENG 

TarsetCEOI 

Char  array 

64 

based  on  CEOI_LENG  and 
MAX  CEOI  RCVR 

TransmitDTG 

Struct 

DTG  type 

TransmitFreauenc' 


TransmitLocation 


FreeText 


ZuluTime 


SerialNumber 


Subtype 


Variation 


Double 


Struct 


Inteser 


Inteser 


Char 


Char 


Char 


Char 


UTM_type 


based  on  ANNOTATION 
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5.1.15.1.2  DIS.types  structure  Head 
Table  82  DIS.types  structure 


bytes 


Description 


unused 


SenderlD 


RadiolD 


TimeStam 


EncodineScheme 


Paddin 


SampIeRate 


Leneth 


Samples 


ProtocolID 


Unused_I5 


TimesForwarded 


SenderTerminal 


SenderPerson 


Altitude 


TareetlD 


TareetTerminal 


TareetPerson 


Char 


Char 


Struct 


Integer 


Struct 


Struct 


Integer 


Integer 


Integer 


Integer 


Integer 


EncodingScheme  type 


Char 


Char 


Char 


Integer 


Struct 


Char 


Char 


SenderCEOI 

8 

based  on  CEOI  LENG 

LastFwdCEOI 

8 

based  on  CEOI  LENG 

TargetCEOI 

Char  array 

64 

based  on  CEOI  LENG  and 
MAX  CEOI  RCVR 

TransmitDTG 


TransmitFreauenc 


TransmitLocation 


FreeText 


ZuluTime 


SerialNumber 


Struct 


Double 


Struct 


UTM_type 


based  on  ANNOTATION 
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5.1.15.1.3  DIS.types  structure  ACK  Specific  type 


Table  83  DIS.types  structure  ACK  Specific  type 


Item  Name 

Type 

bytes 

Description 

OriginalSenderlD 

Struct 

ID  type 

OrieinalSenderTerminal 

Char 

1 

OrieinalSenderPerson 

Char 

1 

AcknowledgelD 

Struct 

ID_  type 

AcknowiedeeTerminal 

Char 

1 

Acknowle  JeePerson 

Char 

1 

OrisinalSenderCEOI 

8 

based  on  CEOI  LENG 

AcknowIedeeCEOI 

8 

based  on  CEOI  LENG 

OrieinalDTG 

DTG  type 

5.1.15.1.4  PIS  types  structure  Ack  type 


Table  84  DIS_types  structure  ACK  type 


Item  Name 

Type  _ 

bytes 

Description 

Header 

Struct 

DMC  Header  type 

Common 

Struct 

DMC  CommonBIock  type 

Specific 

EESlEHl 

Ack  Specific  type 

AcknowIedeelD 

Struct 

ID  type 

5.1.15.1.5  DIS.types  structure  DISAck  type 

Table  85  r)es  structure  DISAck  type 


Item  Name 

Type 

bytes 

Description 

Header_And_Common 

Struct 

Header_and_CommonBIo 
ck  type 

Specific 

Struct 

Ack  Specific  type 
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5.1.15.1.6  PIS  types  structure  Soot  Specific  type 

Table  86  DIS.types  structure  Spot  Specific  type 


Item  Name 

Type 

bytes 

Description 

TimeSiehted 

Struct 

DTG  type 

ObserverLocation 

Struct 

UTM  type 

TareetOuanitv 

2 

Observerl  mentions 

Char 

1 

TareetTvoe 

Char 

1 

Char 

1 

TareetDirection 

Char 

1 

TareetSoeed 

Struct 

Speed  _tvpe 

TareetLocation 

Struct 

UTM  type 

TareetUnit 

16 

based  on  UNIT  LENG 

Unused . 16 

16 

5.1.15.1.7  DIS_types  structure  Spot  type 

Table  87  DIS_types  structure  Spot  type 


Item  Name 

Type 

bytes 

Description 

Header 

Struct 

DMC  Header  type 

Common 

Struct 

DMC  CommonBlock  type 

Specific 

Struct 

Spot  .Specific 

5.1.15.1.8  DIS_types  structure  DISSpot  type 

Table  88  DIS_types  structure  DISSpot  type 


1  Item  Name 

■EZT9H 

bytes 

Description  1 

Header_And_Common 

Struct 

Header_and_CommonBlo 
ck  type 

Specific 

Struct 

Soot_Specific  type 
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5.1.15.1.9  PIS  types  structure  BDA  Specific  type 


Table  89  DIS.types  structure  BDA  Specific  type 


1  Item  Name 

Type 

bvtes 

Description  1 

StrikeTimeStart 

Struct 

DTG  type 

StrikeTimeEnd 

Struct 

DTG  type 

TareetCaieBorv 

Char 

1 

TaraetTvoe 

Chnr 

1 

TarsetsDestroved 

Integer 

2 

PercentCoverage 

Char 

1 

Unused  3 

lalif 

3 

5.1.15.1.10  DIS_types  structure  BDA  type 


Table  90  DIS_types  structure  BDA  type 


Item  Name 

Type 

bytes 

Description 

Header 

Struct 

DMC  Header  type 

Common 

Struct 

DMC  CommonBlock_type 

Specific 

Sturct 

BDA  Specific  type 

5.1.15.1.11  DIS_types  structure  DISBDA  type 

Table  91  DIS_types  structure  DISBDA  type 


Item  Name 

■EETSH 

bvtes 

Description 

Header_and_Common 

Struct 

Header_and_CommonBlo 
ck  type 

Specific 

Struct 

BDA  Specific 
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5.1.15.1.12  DIS.types  structure  GndRoute 

Table  92  DIS_types  structure  GndRoute 


Item  Name 

Type 

bytes 

Description  1 

Char 

1 

ClassificationFormula 

Char 

1 

Unused  6 

6 

ClassFormlnfo 

32 

based  on  RTE_ID  LENG 

RoutelD 

BXSESSV 

32 

based  on  RTF  ID  LENG 

Leftover 

ISTfTlBTBTB 

8 

5.1.15.1.13  DIS.types  structure  AirRoute 

Table  93  DIS_types  structure  AirRoute 


Item  Name 

Type 

bytes 

Description 

Char 

1 

Obstacles 

Char 

1 

Unused  6 

6 

ClassFormlnfo 

32 

based  on  RTE  ID  LENG 

RoutelD 

32 

based  on  RTE  ID  LENG 

Leftover 

8 

5.1.15.1.14  DIS.types  structure  Bridge 

Table  94  DIS.types  structure  Bridge 


1  Item  Name 

Type 

bytes 

Description  1 

■■■■■■■■■■ 

Type 

Char 

1 

Damaee 

Char 

1 

Spans 

Char 

1 

ConstrMaterial 

Char 

1 

Unused  4 

4 

Length 

lai.UMTTlM 

4 

based  on  KEYPAD  4 

Width 

IHIiMMy  J 

4 

based  on  KEYPAD  4 

Height 

4 

based  on  KEYPAD  4 

Under 

BISXSSV 

4 

based  on  KEYPAD  4 

ConstrDescr 

16 

based  on  KEYPAD  16 

ID 

lal.llMUVTlI 

32 

based  on  RTE  ID  LENG 

SpanLength 

4 

based  on  KEYPAD  4 

LoadClass 

FrnBnTTTB 

4 

based  on  KEYPAD  4 
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5.1.15.1.15  PIS  types  structure  T.Z  PZ 

Table  95  DB.types  structure  LZ  PZ 


1  Item  Name 

Type 

bytes 

Description 

Char 

1 

Obstacles 

Char 

I 

Unused.  6 

6 

ObstaclesDescr 

16 

based  on  KEYPAD  16 

ID 

W.f 

16 

based  on  KEYPAD  16 

LZ_Size 

laiiMSUm 

16 

based  on  KEYPAD  16 

Axis 

16 

based  on  KEYPAD  16 

Leftover 

8 

5.1.15.1.16  PIS  types  structure  BP  OP 

Table  96  DIS_types  structure  BP  OP 


1  Item  Name 

Type 

bytes 

Description  1 

HHHIHHIliHHHlH 

■mm 

■■H 

Char 

1 

Obstacles 

Char 

1 

Unused  _6 

6 

ObstaclesDescr 

16 

based  on  KEYPAD  16 

ID 

16 

based  on  KEYPAD  16 

BP_Sizc 

16 

based  on  KEYPAD  16 

Axis 

16 

based  on  KEYPAD  16 

Leftover 

ISTTTBTrm 

8 

5.1.15.1.17  PIS  types  structure  Crossing 


Table  97  DK.types  structure  Crossing 


1  Item  Name 

Type 

bytes 

Description  1 

^■■i 

Char  array 

4 

based  on  KEYPAD  4 

BankSlopeExit 

BiHKTiTTI 

4 

based  on  KEYPAD  4 

CrossincLensth 

4 

based  on  KEYPAD  4 

CrossinsWidth 

4 

based  on  KEYPAD  4 

CrossinsDeoth 

laj.f  IJIUjHI 

4 

based  on  KEYPAD  4 

CurrentFlow 

taj.MMTtilTJ 

4 

based  on  KEYPAD  4 

ID 

BifSETd 

8 

based  on  KEYPAD  8 

Leftover 

lajil  IS  If^TH 

48 
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5.1.15.1.18  DIS_types  structure  Recon  Spec 
Table  98  DIS.types  structure , 
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hem  Name 


Subtype 


bytes 


Union 


Description 


GndRoute,  AirRoute, 
Bridge.  LZ_PZ.  BP.OP, 
Crossins 


5.1.15.1.19  PIS  types  structure  Recon  type 

Table  99  DIS_types  structure 


Item  Name  Type  I  bytes  Description 


Header 


Common 


Specific 


Struct 


Struct 


Struct 


5.1.15.1.20  DIS_types  structure  DISRecon  typ 
Table  100  DIS.types  structure 


Item  Name 


Header.  And.Common 

Struct 

Specific 

Struct 

bytes 


Header.  And.CommonBlo 
cktype 


Recon_Specific_type 


5.1.15.1.21  DIS.types  structure  Repeat 

Table  101  DIS.typ)es  structure  Repeat 
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5.1.15.1.22  DIS.types  structure  Cancel 


Table  102  DIS.types  structure  Cancel 


Item  Name 

Type 

bytes 

Description 

MissionStatus 

Char 

1 

Unused  7 

7 

Leftover 

16 

5.1.15.1.23  PIS  types  structure  CheckFire 

Table  103  DIS_types  structure  CheckFire 


1  Item  Name 

Type 

bytes 

Description 

■■■■■■ 

MissionStatus 

Char 

1 

Unused  _7 

l3!!!SKSm 

7 

Leftover 

16 

5.1.15.1.24  DIS_types  structure  CNO 

Table  104  DB_types  structure  CNO 


Item  Name 

Type 

bytes 

Description 

MissionStatus 

Char 

1 

Unused  7 

7 

Leftover 

16 

5.1.15.1.25  DIS_typ>es  structure  Shift 

Table  105  DIS.types  structure  Shift 


1  Item  Name 

Type 

bytes 

Description 

MissionStatus 

Char 

1 

FireForEffect 

Char 

1 

Unused  6 

6 

Messace 

RTTWTTn!! 

16 

based  on  SHIFT  MSG 

I 

I 
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Table  106  DIS.types  structure  NewMission 


Item  Name 


MissionStatus 


MissionTyoe 


Shell 


Control 


Fuze 


RoundFFE 


Unused 


Leftover 


5.1.15.1.27  DIS_types  structure  MTO 


Table  107  DIS_types  structure  MTO 


Item  Name 


MissionStatus 


Request  Adjustment 


EnterTarset 


EndMission 


Unused  4 


Leftover 


5.1.15.1.28  DIS_types  structure  Shot 


Table  108  DIS_types  structure  Shot 
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5.1.15.1.29  DIS.types  structure  Splash 

Table  109  DS.types  structure  Splash 


Item  Name 


MissionStatus 


RoundsFired 


ImoactTime 


Unused_5 


Leftover 


5.1.15.1.30  DIS.types  structure  EndQfMission 
Table  110  DIS_typ>es  structure 


Item  Name 


March  31, 1993 


MissionStatus 

Char 

Disoositon 

Char 

Casualties 

Char 

RecordTarset 

Char 

CasualtvNumber 

Integer 

Unu$ed_2 

Hii'iMiijnii 

PointNumber 

RlTTBfTTfni 

5.1.15.1.31  DIS.types  structure 

Table  111  DK_t3^s  structure 


Item  Name 


bytes 


■■■ 

MissionID 

16 

based  on  ID  NUM  LENG 

TarsetID 

16 

based  on  ID  NUM  LENG 

Subtype 

Union 

24 

one  of  the  previous 
structures  S.l.lS.1.21 
through  S.l.lS.1.30 
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5.1.15.1.32  DIS.types  structure  Artillery  type 

Table  112  DIS.types  structure  Artillery  type 


Item  Name 

T  ype 

bytes 

Description 

Header 

Struct 

DMC  Header,  type 

Common 

Struct 

DMC  CommonBlock  tvoe 

Soecific 

Struct 

Artillery  Specific  tvoe 

5.1.15.1.33  PIS  types  structure  DISArtillery  type 

Table  113  DIS_types  structure  DISArtillery  type 


Item  Name 

Type 

bytes 

Description 

Header_And_Common 

Struct 

Header.  And_CommonBlo 
ck  type 

Specific 

Struct 

Artillery  Specific  type 

5.1.15.1.34  DIS_typ€S  structure  Moye  Specific  type 

Table  114  DIS.types  structure  Moye  Specific  type 


1  Item  Name 

Type 

bytes 

Description  1 

bbhhhhhhhhhi 

TareetID 

16 

based  on  ID  NUM  LENG 

Task 

Char 

1 

Who 

Char 

1 

When 

Char 

1 

Unused  .3 

3 

ZuluTime 

Integer 

2 

Where 

8 

based  on  WHERE  LENG 

DIG 

Struct 

DTG  .type 
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5.1.15.1.35  PIS  types  structure  Move  type 

Table  115  DlS.types  structure  Move  type 


Item  Name 

Type 

bytes 

Description 

Header 

Struct 

DMC  Header  type 

Common 

Struct 

DMC  CommonBlock  type 

Soecific 

Move  Soecific  type 

5.1.15.1.36  DK  types  stnicture  DISMove  type 


Table  116  DIS.types  structure  DISMove  type 


Item  Name 

Type 

Description 

Header_And_Common 

Struct 

Header.  And.CommonBlo 
ck  type 

Soecific 

Struct 

Move  Specific  tvoe 

5.1.15.1.37  DIS_types  structure  Status  Specific  type 

Table  117  Dis.types  structure  Status  Specific  tyi2fi 


Item  Name 

Type 

132^ 

Description 

Fuel 

Inteser 

2 

Elements 

Char 

1 

FailedEouip 

3 

based  on  FAILED  EQUIP 

Hellfires 

Char 

1 

Stinsers 

Char 

1 

Rockets 

Char 

1 

Rounds 

Char 

1 

ReauestTvoe 

Char 

1 

Unused  S 

lal.llMItiTfl 

5 

1 

I 

I 

1 
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5.1.15.1.38  DIS.types  structure  Status  tyjpe 

Table  118  DIS.types  structure  Status  type 


Item  Name 

Type 

bytes 

Description 

Header 

Struct 

DMC  Header,  type 

Common 

Struct 

DMC  CommonBlock  type 

Specific 

Struct 

Status  Specific  type 

5.1.15.1.39  PIS  types  structure  DISStatus  type 

Table  119  DIS_types  structure  DISStatus  type 


Item  Name 


Type 


bytes 


Description 


Header_And_Common 


Struct 


Header.And.CommonBlo 


Specific 


Struct 


Status  Specific_type 


5.1.15.1.40  PIS  types  structure  Request  Specific  type 

Table  120  DIS_types  structure  Request  Specific  type 


1  Item  Name 

Type 

bytes 

Description  1 

HIHHHHiHiHVHH 

ReportTypc 

Char 

1 

ReconType 

Char 

I 

Unused  _6 

6 

5.1.15.1.41  DIS_types  structure  Request  type 

Table  121  DIS.types  structure  Request  type 


Item  Name 

Type 

bytes 

Description 

Header 

Struct 

DMC  Header  type 

Common 

Struct 

DMC  CommonBlock  type 

Specific 

Struct 

Request.  Specific  type 
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5.1.15.1.42  DIS.types  structure  niS£ej|USSLJ:: 

Table  122  DIS.types  structure 


Item  Name 


bytes 


Description 


Header.  And.Common 

Struct 

Specific 

Struct 

Header.And.CommonBlo 
ck_type  _ 


Reauc5t_Specific_type 


5.1.15.1.43  DIS_types  structure  NBC  1 
Table  123  DlS.types  structure . 


Item  Name 


bytes 


Description 


Description 


BurstType 


CloudHtUnits 


CloudWidth 


CloudDescr 


CloudHeisht 


FlashBanstime 


Unused  4 


StartDTG 


EndDTG 


Char 


Char 


Char 


Float 


Integer 


Integer 


16  I  based  on  CLOUD  DESCR 


2 


2 


Struct 


Struct 


5.1.15.1.44  DIS.types  structure  NBC  4 

Table  124  DIS.types  structure  NBC  4 


Item  Name 


bytes 


Description 


Description 

Char 

BurstType 

Char 

Char 

CloudHtUnits 

Char 

CloudWidth 

Float 

CloudDescr 

BicKssni 

CIoudHeight 

Integer 

DoseRate 

Integer 

Unused_4 

Mil  IMUIBi 

StartDTG 

Struct 

EndDTG 

Struct 

1 6  based  on  CLOUD_DESCR 


2 


2 
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5.1.15.1.45  DIS.types  structure  NBC  Nc 
Table  125  DIS.types  structure . 


Subtype 

Uoion 

64 

one  of  the  preyious 
structures  S.1.1S.I.43 
throush  5. 1. 15. 1. 45 

5.1.15.1.47  DlS^types  structure  NBC  type 

Table  127  DIS_typ)es  structure  NBC  type 


Item  Name 


bytes 


Desciiption 


Header 

Struct 

Common 

Struct 

Specific 

Struct 

5.1.15.1.48  DIS_t3rpes  structure  DISNBC  type 
Table  128  DIS_types  structure 


Item  Name 


Header.And.Common 

Struct 

Specific 

Struct 

Header.  And.CommonBlo 
ck.type  _ 


NBC_Specific_type 
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5.1.15.1.49  PIS  types  structure  MTTI  Specific  type 

Table  129  DIS.types  structure  Mill  Specific  type 


Item  Name 

Tvoe 

bvtes 

DescriDtion 

AffectedRadioFrea 

Double 

8 

ProgrammedFreq 

32 

KevDadEntrv 

16 

based  on  KEYPAD  16 

JamStartDTG 

16 

DTG  tvoe 

JamEndDTG 

nniBmm 

16 

DTG  tvoe 

DescriDtion 

Char 

1 

PercentLost 

Char 

1 

Tvoe 

Char 

1 

Unused  5 

Char  array 

5 

5.1.15.1.50  DIS_types  structure  Min  type 

Table  130  DIS_types  structure  MITI  type 


Item  Name 

Tvoe 

bvtes 

DescriDtion 

Header 

Struct 

DMC  Header  tvDe 

Common 

Struct 

DMC  CommonBlock  tvoe 

Soecific 

Struct 

96 

Mill  Soecific  tvoe 

5.1.15.1.51  DIS.types  structure  DISMITI  type 

Table  131  DIS.types  structure  DISMITI  type 


Item  Name 

Tvoe 

bvtes 

DescriDtion 

Header.And.Common 

Struct 

Header.  And  .CommonBlo 
ck_tvoe 

Soecific 

Struct 

96 

MIJI  Soecific  tvoe 
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5.1.15.1.52  PIS  types  structure  PIREP  Spec 
Table  132  DIS_types  structure , 


March  31, 1993 


Item  Name 


bytes 


Description 


Restrictions 


CloudCover 


imijiiiijiLiuj 


IcineTvpe 


WindDirection 


WindSoeed 


OutsideAirTem 


Barometer 


CloudBase 


CloudTo 


Char 


Char 


Char 


Char 


Char 


Char 


Char 


Integer 


Integer 


Float 


Integer 


Integer 


5.1.15.1.53  PIS  types  structure  PIREP  type 

Table  133  DIS_types  structure 


Item  Name  I  Type  bytes 


Header 

Struct 

Common 

Struct 

Specific 

Struct 

5.1.15.1.54  DIS_types  structure  DISPIREP  typ 
Table  134  DIS.types  structure 


bytes 
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5.1.15.1.55  PIS  types  structure  DNAV  Specific  type 


Table  135  DB_types  structure  DNAV  Specific  type 


1  Item  Name 

Type 

bytes 

Description  1 

■■■mi 

mm 

AircrafiTvoe 

Char 

1 

AircraftStatus 

Char 

1 

PilotStatus 

Char 

1 

Unused  S 

5 

5.1.15.1.56  DIS_types  structure  DNAV  type 

Table  136  DIS.types  structure  DNAV  type 


Item  Name 

Type 

bytes 

Description 

Header 

Struct 

DMC  Header  type 

Common 

Struct 

DMC  CommonBIock  type 

Specific 

Struct 

8 

DNAV  SoeciHc  type 

5.1.15.1.57  DIS_types  structure  DISDNAV  type 

Table  137  DlS^types  structure  DISDNAV  type 


Item  Name 

Type 

bytes 

Description 

Header.And.Common 

Struct 

Header.  And.CommonBIo 
ck  type 

Specific 

Struct 

8 

DNAV  Specific  type 

5.1.15.1.58  PIS  types  structure  FreeText  Specific  type 

Table  138  DIS_types  structure  FreeText  Specific  type 


Item  Name 

Type 

bytes 

Description 

FreeText 

Char  array 

256 

based  on 

FREETCXTLENG 
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5.1.15.1.59  PIS  types  structure  FreeText  type 
Table  139  DlS^types  structure , 


Item  Name  Tyoe  I  bytes 


Descriotion 


Header 


Common 


Soecific 


Struct 


DMC_Header_type 


DMCCommonBlock  type 


256  I  FreeText  Specific  type 


5.1.15.1.60  DIS_types  structure  DISFreeText 
Table  140  DIS.types  structure 


Item  Name 


Header_And_Common 

Struct 

Specific 

Struct 

bytes 


Header_And_CommonBlo 
ck_type  _ 


256  I FreeText_Specific_tyoe_ 


5.1.15.1.61  DIS_types  structure  DMCPDU  typ 
Table  141  DIS_types  structure 


Item  Name 


bytes 


Variant 

Ack 

Spot 

BDA 

Recon 

Artillery 

Moye 

Status 

Request 

NBC 


Rirn 


PIREP 

DNAV 

FreeText 


one  of  the  following 

structures  : 

Ack_type 

Spot.type 

BDA_type 

Recon_type 

Artillery_type 

Move_type 

Status_type 

Request.type 

NBC_type 

Min.iype 

PIREP_type 

DNAV_type 

FreeText_tyoe 


I 

I 

I 
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5.1.15.1.62  PIS  types  structure  DMCDISPDU  type 


Table  142  DIS_types  structure  DMCDISPDU  type 


Item  Name 

Type 

bvtes 

Descriotion 

Variant 

DISAck 

DISSpot 

DISBDA 

DISRecon 

DISAitillery 

DISMove 

DlSSutus 

DISRequest 

DISNBC 

DISDISMIJI 

DISPIREP 

DISDNAV 

DISFreeText 

Union 

one  of  the  following 
structures  : 

DISAck.type 

DISSpot.type 

DISBDA.type 

DISRecon.type 

DISArtillery.type 

DISMove.type 

DISStatus.type 

DISRequest.type 

DISNBC.type 

DISMIJI.type 

DISPIREP.type 

DISDNAV.type 

DISFreeText  tvoe 

5.1.15.2  DMC_PDU  define  statements 


Table  143  DIS.types  define  statements 


I 

I 
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DMC  NBC_PPU 


DMC  MIJIPDU 


DMC  PIREP  PDU 


DMC  DNAV_PDU 


JTEXT.PDU 


DMC  ATHS_PDU 


NUMBER_DMC_PDUS 


l»lg£aifl£3 


DMC  HDRSPARE 


DMC  COMMON 


COMMON 


CEOILENG 


MAX  CEOIRCVR 


ANNOTATION 


SIM_UNUSED_ARRAY_SIZE 


UNIT  LENG 


DMC_RECON_GND_ROUTE_PDU 


DMC_RECON_AIR_ROUTE_PDU 


DMC_RECON_BRIDGE_PDU 


DMC_REC0N_L2_PZ_PDU 


DMC_RECON_BP  OP_PDU 


DMC_RECON  CROSSING  PDU 


NUM_DMC_RECON_PDUS 


DMC_ARTY_REPEAT_PDU 


DMCARTYCANCEL  PDU 


DMC_ARTY_CHECK_PDU 


DMC_ARTYjCNO_PDU 


DMC_ARTY_SHIFT_PDU 


DMC_ARTY_NW  MSN.PDU 


DMC_ARTY_MTO_PDU 


DMC_ARTY_SHOT  PDU 


DMC_ARTY_SPLASH_PDU 


DMC_ARTY_EOM_PDU 


DMC  ARTY  NEGLECT_PDU 


NUM_DMC_ARTY_PDU 


SHIFT  MSG 


PT_NUM 


FAILED.EOUIP 


DMC_NBC_1_PDU 


DMC_NBC_2_PDU 


DMC_NBC_3_PDU 


DMC_NBC_4  PDU 


DMC_NBC_5_PDU 


NUM_DMC_NBC_PDUS 
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5.1.16  DMC^types.h 

This  header  file  contains  definitions  of  various  basic  data  elements, 
including  how  these  elements  are  represented  as  communicated  bits.  The 
elements  compose  the  fields  which  comp<^  each  PDU. 


5.1.16.1.1  DMC_types  structure  DTG  type 

Table  144  DMC.types  structure  DTG  type 


Item  Name 

Type 

Description 

Hundredth 

2 

tMued  on  TWO.DIGITS 

Second 

QjnzszsH 

2 

based  on  TWO.DIGTTS 

Minute 

2 

based  on  TWO.DIGITS 

Hour 

isnzssH 

2 

based  on  TWOlDIGITS 

Day 

Qszszm 

2 

based  on  TWO.DIGITS 

Month 

ESEsm 

2 

based  on  TWO.DIGITS 

Year 

4 

based  on  FOUR.DIGITS 

5.1.16.1.2  PMC  types  structure  EncodingScheme  type 

Table  145  DMC_types  structure  EncodingScheme  type 


Item  Name 

Type 

cm 

Description 

Class 

Integer 

2 

2  bit  field 

Scheme 

14  bit  field 

5.1.16.1.3  DMC.types  structure  UTM  type 

Table  146  DMC.types  structure  UTM  type 


Item  Name 

Type 

Description 

Sector 

P'r  '■  Ilf  rM 

2 

based  on  TWO.DIGITS 

EastinK 

lirnFnn* 

7 

based  on  UTM.MAP.COORD 

ISSliSinHHHHHHIi 

7 

based  on  UTM.MAP.COORD 
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5.1.16.1.4  PMC  types  structure  Speed  type 

Table  147  DMC_types  structure  ^peed  type 


5.1.16.2  DMC.types  define  statements 

Table  148  DMC.types  define  statements 
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ACTIVITY_RETREATING 
ACTIVITY_ADVANCING 
ACriVlTy_ATTACKING 
ACnvmr.DAMAGED 
ACnVlTY.KILLED 
ACTIVrrY_MOBILE_iaLL 
TARGET.UNKNOWN 

TARGET_ADA _ 

TARGET_SAM _ 

TARGET.TANK _ 

TARGET.WHLD _ 

TARGET.TRKD _ 

TARGET_ACFT _ 

TARGET.TRPS _ 

TARGET.UNCL _ 

DIRECTION.N _ 

DlRECnON.NE _ 

DlRECnON.E _ 

DIRECTION.SE _ 

DIRECTION.S 
DIRECTION.SW 
DIRECTION.W 

DIRECTION.NW _ 

OBS_INT_OTHER _ 

OBS.INT.CONT.MSN 

OBS.INT.ENGA _ 

OBS,INT,HLD _ 

OBS_lNT_RTS_lHLP 
OBS_INT_OBSV_TGT 
CLASSFORM.NULL 

CLASSFORM.W _ 

CLASSFORM.TYPE 
CLASSFORM.MLC 
CLASSFORM.OHC 

CLASSFORM_OB _ 

CLASSFORM.BLOCK 
OBSTACLES_NONE 
OBSTACLES.KEYPAD 
OBSTACLES_ADA 
OBSTACLES,TOWR_ANT 
OBSTACLES_WlRES 
OBSTACLES.TERR 
OBSTACLES.TREES 
OBSTACLES.BLPG  _ 
OBSTACLES,NDST_CAMP  8 

OBSTACLES.OTHER _ 9 

BRDGTYP_UNKNOWN _ 0 

BRDGTYP.TRUSS _ 1 

BRDGTYP_GIRDER  2 
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BRDGTYP.BEAM  I  3 

BRDGTYP_SLAB _ 

BRDGTYP.CLOS _ 

BRDGTYP.ARCHOP _ 

BRDGTYP.SUSPEN _ 

BRDGTYP_FLOATlNG 

BRDGTYP_SW1NG _ 

BRIXSDMG.NONE _ 

BRDGDMG_LIGHT _ 

BRDGDMG_MODERATE 

BRDGDMG.SEVERE _ 

BRDGDMG.DESTROYED 
BRDGCONMAT_UNKNOWN 
BRPGCONMAT_KEYPAD 
BRDGCONMAT.METAL 
BRPGCONMAT_STONE 
BRPGCONMAT.CONCRETE 

ACT_LIKELY_NONE _ 

ACT_LIKELY_EXPECTED 
ACT_LlKELY_POSSIBLE 
ACT_LIKELY_UNLIKELY 

MSNSTAT.NULL _ 

MSNSTAT.REQUESTED 

MSNSTAT.READY _ 

MSNSTAT.SHOT _ 

MSNSTAT.SPLASH _ 

MSNTYPE.NULL _ 

MSNTYPE_FFE _ 

MSIsmrPE_ADI_FlRE _ 

MSNTYPE_IMMED_SUPPR 

MSNTYPE_SUPPR _ 

SHELL_NULL _ 

SHELL.HE _ 

SHELL.ICM _ 

SHELL.CPRHD _ 

SHELL.SMOKE _ 

SHELL_WP _ 

SHELL_CORD_ILLUM 

CNTL_NULL _ 

CNTL_AMC 
CNTL.WR 

CNTL_TOT _ 

FUZE_NULL _ 

FUZE.QUICK _ 

FUZE.TIME_DELAY _ 

FUZE_CONCR_PRCNG 

TRALLOW _ 

TRALHIGH _ 

TRALOTHER  \  2 
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DSPN_NULL 


DSPN_NOT_GIVEN 


DSPN  BURNING 


DSPN.CNO 


CSLTNULL 


CSLT_NOT_GIVEN 


CSLTGIVEN 


TASKNULL 


TASKTO 


TASK_HOLD 


TASKCONT.MSN 


TASK_RENEZ_AT 


TASKENGATGT 


TASK_MOVING_TO 


TASK_HLDG_AT 


TASK_ARRVG_AT 


TASK.PASSGTHRU 


TASKDEPRTG.FROM 


MVWHO.NULL 


MVWHO.MYPOS 


MVWHO_B2 


MVWHO_B3 


MVWHO  OPl 


MVWHO_OP2 


MVWHENNULL 


MVWHENIMMED 


MVWHEN.WHNRDY 


MVWHENAMC 


MVWHEN.DTG 


BADEQPT_NULL 


BADEQPT.ENGl 


BADEQPT_ENG2 


BADEQPT.GUNS 


BADEQPT.RADIO 


BADEQPT.DSGNTR 


BADEQPT.RKTPOD 


BADEQPT_MSLSTN 


BADEQPT.RADAR 


BADEQPT.LASER 


REPTrYP_NONE 


REPTTYP  STATUS 


REPTTYPSPOrr 


REPTTYP_RECON 


REPTrYP_MOVEMENT 


RECTYP_NONE 


RECTYP_GND_RTE 


RECTYP_AIR_RTE 


RECTYP_LZ_PZ 


RECTYPBPOP 
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RECTYP.CROSSING  [  5 


BURST.NONE _ 0 


BURST.UNKNOWN  1 


BURST.SURFACE  2 


BURST.AIR  3 


BURST.GND 


DLVRY.UNKNOWN  0 


DLVRY.ARTY 


DLVRY.MORTAR  |  2 


DLVRY.ROCKET  |  3 


DLVRY.MISSLE 


DLVRY.BOMB  I  5 


CLDHT.UNUSED _  [  0 


CLDHT.DEGREES 


CLDHT_HT_IN_FT  I  2 


CLDHT_HT_IN_M  _ ^  3 


NBCDESC.UNUSUAL  0 


NBCDESC.INITIAL 


NBCDESCJNCREASING  I  2 


NBCDESC.DECREASING  3 


NBCDESC.PEAD 


NBCDESC.SPECIAL  |5 


NBCDESC.SERIES  6 


NBCDESC.VERIFICATION 


NBCDESC.SUMKJARY  8 


MIJIDESC.UNKNOWN  |  0 


MIJIDESC.INTERMIT 


MIJIPESC.CONT  I  2 


MIJIDESCJMrrATIVE  I  3 


MIJIDESC.WARBLING 


MIJIDESC.MUSIC  I  5 


MIJIPESC.KEYPAD  |  6 


MIJITYPE.UNKNOWN  j  0 


MI)ITYPE_MEACONlNG 


MI)ITYPE_INTRUSION  I  2 


MIJITYPEJAMMING  I  3 


MIJITYPEJNTERFERE 


VISLUNLIMITED 


VISLHALF.MILE 


VISI_ONE_MILE  I  2 


VISI.TWO.MILE  I  3 


VISI_THREE_MILE 


VlSI_FOUR_MlLE  \  5 


VISLFIVE.MILE  I  6 


VISI_RESTR_NONE  0 


VISI_RESTR_HAZE 


V1S1_RESTR_RAIN  2 


VISI.RESTR.SNOW  3 


VISI_RESTR_FOG 
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VISLRESTR.SMOKE 

5 

VISI_RESTR_DRIZZLE 

6 

VISI_RESTR_DUST 

7 

VISI_RESTR_BLIZZARD 

8 

CLDCVR_NONE 

0 

CLDCVR  OVERCAST 

1 

CLDCVR_BROKEN  I  2 


CLDCVR.SCATTERED  I  3 


TRBINT.NONE  |  0 


TRBINT.LIGHT 


TRBINT_MODERATE  \  2 


TRBINT.SEVERE _ I  3 


TRBINT.EXTREME 


TRBFREQ-NONE _ 

TRBFREQ_CX:CASION 

TRBFREQ_INTERM1T 

TRBFREQ_CONT 

ICElNT_NONE _ 

ICEINT_TRACE _ 

ICEINT_LIGHT _ 

ICEINT_MODERATE 

ICEINT_SEVERE _ 

ICETYP.NULL _ 

ICETYP.RIME _ 

ICETYP.CLEAR _ 

ACRFT.TYP.UNKNOWN 

ACRFT_TYP_RAH66 

ACRFT_TYP_AH64 _ 

ACRFT_TYP_OH58 _ 

ACRFT_TYP_AH1 _ 

ACRFT_TYP_UH1 _ 

ACRFT_TYP_CH47 _ 

ACRFT_TYP_OVl _ 

ACRFT_TYP_OH6 _ 

ACRFT_TYP_CH54 _ 

ACRFT_TYP_UH60 _ 

ACRFT.TYP.RPV _ 

ACRFT_STAT_UNKNOWN 

ACRFT_STAT_RECOVER 

ACRFT_STAT_DAMAGED 

ACRFT_STAT_DESTROYED 

PILOT_STAT_UNKNOWN 

PILOT.STAT,GOOD 

PlLOT_STAT_WIA _ 

PlLOT_STAT_KlA _ 

PILOT_STAT_POW 
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5.1.17  dms.h 

This  header  file  contains  parameters  for  the  Digital  Message  Server 
routines. 


5.1.17.1.1  dms  structure  msgdests  t 


Table  149  dms  structure  msgdests  t 


1  Item  Name 

_ 

Description  | 

HHHHHHHHHHIH 

1  name 

8 

I.Hk'.M.IAM  1  1  ii'ili^H 

5.1.17.1.2  dms  structure  dms  shmem  t 


Table  150  dms  structure  dms  shmem  t 


1  Item  Name 

Iyp€ 

Description  | 

1 

nbr_readers 

4 

dests 

Array  of 

Struct 

64 

msgdesO 

exercise.id 

Char 

1 

pduJenKth 

4 

pdu 

1500 

based  on  MAXPDUSIZE 

5.1.17.1.3  dms  structure  dms  outgoingmsg  t 

Table  151  dms  structure  dms  outgoingmsg  t 


1  Item  Name 

lYPe 

13^ 

Description 

:  ^^h^^ihhhhhhi 

BHHHHIi 

1 

4 

dm_size 

Inteaer 

4 

dm 

m^rrrmm 

1500 

based  on  MAXPDUSIZE 
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5.1.17.1.4  dms  structure  log 

Table  152  dms  structure  log 


Item  Name 


id 


exercise.id 


dests 


Char 


Array  of 
Struct 


5.1.17.1.5  dms  structure  dms  msg  t 

Table  153  dms  structure 


Item  Name 


mg 

Union 

69 

either  shinein_addr  or  log 
Struct  -  5.1.17.1.4 

5.1.17 dms  define  statements 

Table  154  dms  define  statements 


Name 


MAXMSGDEST5 


MAXDESTSIZE 


MAX  CLIENTS 


MAXPDU 


MAXPDUSIZE 


MSG_LOGIN 


MSG_LOGOUr 


MSG.DMAVAIL 


MSG.DONE 


MSG_NEWDESTS 


MSG_FREE 


MSG_CLEANUP 


DMC_MAXMSGTYPE 


DMS_ENET_RECEIVE 


DMS_ENET_TRANSMrr 


KEY 


KEY 


INCOMING_SHMEM_KEY 


DMS_PERMS 
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5.1.18  fcn_proto.h 

In  C,  function  prototyping  (the  dehning  the  input  arguments  and 
resultant  output  from  the  fwction)  is  required.  The  compUer  will  check  the 
prototyping  of  a  function  against  the  actual  arguments  us^  within  the  source 
code  of  the  calling  function  and  flag  as  a  compiler  error  any  incongruities. 

This  header  file  prototypes  all  of  the  general  use  functions  used  in  the  DMC. 


5.1.19  global.netif.h 

This  header  file  defines  the  globally  used  parameters  for  use  by  die 
ethemet  interface  functions,  identifies  and  dimensions  external  data  entities 
and  prototypes  the  DIS  and  SIM  network  interface  functions.  Table  5.1.19.1 
structures  is  not  applicable. 
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5.1.19.2  global.netif  define  statements 

Table  155  globaLnetif  define  statements 


Name 

1  Value 

DSAP 

Oxaa 

SSAP 

Oxaa 

CNTL 

SIM_SOCKET_NAMEl 

soc l 

SIM_PROTOCOL_ID 

SIM_PROTCX:OL_ID_Bl 

SIM_PROTCX:OL_ID_B2 

SIM_PROTOCOL_ID_B3 

OxOB 

SIM_ETHER_TYPE_B1 

0x52 

SIM_ETHER_TYPE_B2 

SIM_BROADCAST_TYPE 

OxFF 

DIS_BROADCAST_ADDR 

Ox89F9200 

DIS_PROTOCOL_ID 

DIS_PROTOCOLJD_Bl 

0x00 

DIS_PROTOCOL_ID_B2 

0x00 

DIS_PROTOCOL_ID_B3 

DIS_ETHER_TYPE_B1 

0x52 

DIS_ETHER_TYPE_B2 

0x09 

HEADER 

0 

DATA 

1 

MAXIOV 

2 

TEST_PDU_FN_SIZE 

40 

SlTE_SIMULATOR_BYTES 

4 

ETHER_TyPE_POS 

6 

PROTOCOL_ID_POS 

3 

READONLY 

0 

SYS_ETHER_ADDR 

"ETHER" 

SYS_IP_ADDR 

"INET" 

SYS_IP_BROADCAST_ADDR 

"BROADCAST" 

5.1.20  global.vars.h 

This  header  file  defines  the  globally  lased  parameters  for  use  by  the 
DMC  functions,  identifies  and  dimensions  exterxud  data  entities  and 
prototypes  the  PDU  decode  functions.  Table  5.1.20.1  structures  is  not 
applicable. 
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5.1.20.2  global.vars  define  statements 

Table  156  gld>aLvars  define  statements 


Name 

Value 

Description 

TRUE 

1 

FALSE 

0 

UNUSED 

0 

SIGREC 

SIGUSRl 

SIGXMT 

SIGUSR2 

USEC_PER.MS 

1000 

MSEC_PER_SEC 

1000 

MSEC_PER_HOUR 

USEC_PER_SEC 

1000000.0 

SEC_PER_HOUR 

n 

USEC_PER_HOUR 

DIS_TIME_UNITS 

(double)0x80000000 

»  03965 

BAMS_PER_DEGREE 

(noat)0x80000000/ 

(HoaOlSO 

5.1.21  netif.h 

This  header  file  defines  the  globally  used  parameters  for  use  by  the 
network  interface  functions  in  sizing  arrays  and  pointing  to  particular  bytes 
within  a  PDU. 

5.1.21.1.1  netif  structure  Int  Array 


Table  157  dms  structure  Int  Array 


1  Item  Name 

Type 

Description 

1  ethemet_address 

24 

based  on  ENETADDRSZ 
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5.1.21^  netif  define  statements 

Table  158  netif  define  statements 


Name 

Value 

Description 

MAX_IFNAME_SIZE 

10 

ETHER_HDR_SIZE 

14 

DISADDRSZ 

I  4 

ENETADDRSZ  ^ 

6 

MAX_LINE_WIDTH 

132 

ETHERTYPE_SIM 

ETHERTYPE_DIS 

PROMISCUOUS_MODE 

5.2  DMCC  Include  FUes 

The  following  table  maps  the  DMCC  CSCI  include  filesfor  interprocess 
commuiucation,  the  PDU  Builder,  and  the  digital  message  server,  and  CSC's 
and  CSU's  that  use  them; 

Table  159  DMCC  CSC/CSU  Data  FUe  Map 


CSC 

CSU's 

INCLUDE 

FILENAME 

COMMENTS 

dms 

All 

dms.h 

Contains 
parameters  and 
data  structures  for 
inter  process 
communication 

build  pdu 

All 

dms.h 

Contains 
parameters  and 
data  structures  for 
inter  process 
communication 

ipc 

All 

dms.h 

Contains 
parameters  and 
data  structures  for 
inter  process 
communication 
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6.  CSCI  data  files. 

6.1.  The  DMCC  CSQ  uses  one  external  data  file  which  contains  an  integer. 
This  integer  expresses  the  difference  in  minutes  between  Local  Time  and 
Zxilu  Time  (also  known  as  Greenwich  Mean  Time,  or  GMT). 


Name: 

'7tmp/dmcc_timezone_offset" 

Format: 

Contains  a  single  integer  value 
Location: 

Maintained  in  temporary  files  directory  directory:  /tmp. 

Description: 

The  dmcc.timezone.offeet  file  is  a  block  oriented  file  containing  a  single 
integer.  The  contents  of  the  file  are  asdi  readable.  The  value  represents  ^ 
number  of  minutes  that  local  time  is  ahead  of  Zulu  time  (that  is,  the  number 
of  minutes  to  be  subtracted  from  local  time  to  obtain  Zulu).  If  the  value  of 
this  integer  is  positive,  then  local  time  is  ahead  of  Zulu  time;  if  the  value  is 
negative,  then  local  time  is  "behind"  Zulu  time. 


GMT  =  ZULU. 
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7.  Requirements  traceability. 

Requriements  traceablility  are  covered  under  Section  4#  Preliminary  Design. 

8.  Notes. 

GLOSSARY  and  ACRONYMS 

DMCC:  Digital  Message  Communications  Console 

DMC:  Digital  Message  Communications 

DMCS:  Digital  Message  Communications  System 

CBDL  Communications  Electronic  Operational  Identifier  (Call  Sign) 

Sys  Main:  System  Main 

SMD:  Situation  Management  Display 

TMI:  Tactile  Message  Indicator 

CQC  Cockpit  Interactive  Keyboard 

MOVCMD:  Movement  Command 

IPC  Unix  System  V  Interprocess  Communications 

GUI:  Graphical  User  Interface 

MTO:  Message  To  Observer 

CNO:  Can  Not  Observe 

ARTY:  Artillery 

BDA:  Battle  Damage  Assessmoit 

PIREP:  Pilot  Report 

ENET:  Ethernet 

SIMNET:  Simulation  Network 

DIS:  Distributed  Interactive  Simulation 

PDU:  Protocol  Data  Unit 

APDU:  Association  Layer  Proto<x>l  Data  Unit 

X  X'Windows  Windowing  System 

OSF  Op)en  Software  Foundation 

BX  Builder's  Xcessory 

CSC:  Computer  Software  Component 

CSU:  Computer  Software  Unit 

DMS:  Digital  Message  Server 

NBC:  Nuclear,  Biological,  Sc  Chemical  Weapons 

DTG:  Date  Time  Group 

UTM:  Universal  Transverse  Mercator 

CSQ:  Computer  Software  Configuration  Item 
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10.  Appendix  A  -  DMCC  Software  Structure  Charts. 

The  structure  charts  on  this  and  the  following  pages  depict  collectively  the 
overall  structure  of  the  DMCC  CSCI. 
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10.1  DMCCCSa 


Figure  13  Top  Level  DMCC  CSQ  Structure 
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lOJZ  CSC  dms 


Figurel4  CSC  dms  Structure 
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103  CSCbuild^du 


Figure  15  CSC  lniild_pdu  Structure 
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10.4  CSC  ipc 


Figure  16  CSC  ipc  Structure 
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10.5  CSC  dmcc_siin_tx 


CSC 

dmcc_slm_tx 

1 

I  csu 

1  dmsinit 

1  CSU 

1  dms-recvdm 

CSU 

ALPDU_S  1  M^encode 

1 

1 

1 _ 

CSU 

SIM_tx..netlf 

1 

— j 

CSU 

alt_flush 

-I 

CSU 

ether_open 

_ _ 1 

H 

CSU 

nloctl 

CSU 

ether-interfaces 

Figure  17  Sublevel  CSC  dmcc.sim.tx  Structure 
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10.6  Sublevel  CSC  dmcc_sim_rx 


Figure  18  Sublevel  CSC  dmcc.sim.rx  Structure 
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10.7  CSC  pdu.decode 


csu 

pduu3pec-d*cod« 

CSU 

d«code-aclc_pdu 

CSU 

(>«co<l«_spot-pdu 

CSU 

dacodc-bda-pdu 

CSU 

decode_frM_ttxt_pdu 

CSU 

d«cod«^irroute-pdu 

CSU 

d«CQd«JM‘(d9t.j>du 

CSU 

d«cod«-lzpz-pdu 

CSU 

dtcode-bpop_pdu 

CSU 

pdu_crossln9_d«co<lt 

CSU 

d«cod«_r«ptat_pdu 

Hgurel9 


03036 


March  31, 1993 


CSC  pdu.decode  Structure 
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10.8 


CSC  client 


Figure  20  CSC  client  Structure 
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20.  Appendix  B  -  DMCC  "C*  Source  Data  Structures. 

This  is  the  set  of  "C"  language  header  files  (*.h)  which  describe  the  various 
datastructures  and  other  data  files  .  These  files  are  located  in  the  ADST 
Configuration  Management  Directory,  tmder  the  following  pathnames 

a3  /adst-cm/dmcc/include 
a3  /  adst-cm  /  dmcc  /  gui  /  include 
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30.  Appendix  C  -  DMCC  Client  State  Transition  Diagram. 

The  diagram  on  the  following  pages  shows  the  various  states  the  CLIENT 
process  can  occupy,  and  the  various  actions  which  cause  the  process  to  change 
states.  This  diagram  is  an  Excel  3.0  spreadsheet  found  in  the  MCC  Software 
Development  FUe  under  pathname  IRM/ADST  Madid  #2/MCC 
SDF/oieliverable  Documents/DMCC  State  Transition  Diagram. 

The  X-Client  Process  State  Event  Matrix  is  shown  on  the  following  pages.  This 
diagram  shows  actions  and  transitions  from  various  window  states  bound  to 
event  flags  representing  operator  intervention,  such  as  clicking  on  a  button 
region  of  a  window.  Each  cell  shows  what  actions  are  taken  as  a  result  of  an 
event  followed  by  a  semicolon  (;)  character,  which  is  followed  by  an  indication  of 
the  next  window  to  transition  to  (make  active),  if  any.  The  top  row  is  a  list  of  the 
window  events  and  the  left  column  is  a  list  of  window  states. 
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Table  160  Client  State  Transition  Table 


Logon  to 
Network 
Selected 

Stand  Alone 
Selected 

Sys  Main 
Selected 

Address 

List 

Selected 

Logon 

Window 

Active 

Logon  name 
and  exercise 
ID  to 

Network;  go 
to  SYS  MAIN 

No  Logon,  Go 
to  SYS  MAIN 

n/a 

n/a 

Sys  Main 

Window 

Active 

n/a 

n/a 

n/a 

Go  To  Address 
List  Window 

Address 
List  Edit 
Window 
Active 

n/a 

n/a 

Record 
Address  List, 
Go  to  Sys 
Main 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

n/a 

Record 
Location  List, 
Go  to  Sys 
Main 

n/a 

CEOI  / 
Group  List 
Edit 
Window 
Active 

n/a 

n/a 

Record  CEOI/ 
Group  List, 
Go  to  Sys 
Main 

n/a 

Sys  Main 
Msg 

Window 

Active 

n/a 

n/a 

Go  to  Sys 
Main 

n/a 

Sys  Main 
Msg  Read 
Window 
Active 

n/a 

n/a 

Go  to  Sys 
Main 

n/a 

Sys  Main 
Rprt 
Window 
Active 

n/a 

n/a 

Go  to  Sys 
Main 

n/a 
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Table  160 


CEOI/ 
Group  List 
Selected 

Logon 

Window 

Active 

n/a 

Sys  Main 

Window 

Active 

Go  to  CEOI/ 
Group  List 
Window 

Address 
List  Edit 
Window 
Active 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

CEOI  / 
Group  List 
Edit 
Window 
Active 

n/a 

Sys  Main 
Msg 

Window 

Active 

n/a 

Sys  Main 
Msg  Read 
Window 
Active 

n/a 

Sys  Main 
Rprt 
Window 
Active 

n/a 

March  31, 1993 


Client  State  Transition  Table,  cont. 


Location 

List 

Selected 

MSGS 

Selected 

RPRT 

Selected 

n/a 

n/a 

n/a 

Goto 

Location  List 
Window 

Go  to  Sys 
Main  Msg 
Window 

Go  To  RPRT 
Window 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


Up  Selected 

Down 

Selected 

Add 

Selected 

Delete 

Selected 

Logon 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Address 
List  Edit 
Window 
Active 

Round-Robin 

address 

highlight 

Round-Robin 

address 

highlight 

Add  Address 
to  Address 
List 

Delete 
selected 
Address  from 
Address  List 

Location 
List  Edit 
Window 
Active 

Round-  Robin 
Location 
highlight 

Rouund- 

Robin 

Location 

highlicy^t 

Add  Location 
to  Location 
List 

Delete 
selected 
Location  from 
Location  List 

CEOI  / 
Group  List 
Edit 
Window 
Active 

Round-Robin 

Group 

highlight 

Round  Robin 
Group 
highlight 

Add  Group 
Name  to 
Group  List 

Delete  Group 
Name  from 
Group  List 

Sys  Main 
Msg 

Window 

Active 

n/a 

n/a 

n/a 

Delete 

Selected 

Message 

Sys  Main 
Msg  Read 
Window 
Active 

n/a 

n/a 

n/a 

Delete  Shown 
Message 

Sys  Main 
Rprt 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


READ  Logout  Prev  Next 

Selected  Selected  Selected  Selected 


Logon 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 

Window 

Active 

n/a 

Logout,  shut 
down  client 
process 

n/a 

n/a 

Address 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

CEOI  / 
Group  List 
Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg 

Window 

Active 

Retrieve 
message,  go 
to  Sys  Main 
Msq  Read 

n/a 

Round-Robin 

message 

highlight 

Round-Robin 

message 

highlight 

Sys  Main 
Msg  Read 
Window 
Active 

Go  to  Sys 
Main  Msg 
Window 

n/a 

n/a 

n/a 

Sys  Main 
Rprt 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


Re'Use  Reply  Save  &  Exit  Save  & 
Selected  Selected  Selected  Return 

Selected 


Logon 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Address 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

CE01  / 
Group  List 
Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg 

Window 

Active 

Mark 
currently 
selected 
message  for 
re-use,  go  to 
Sys  Main 
Rprts 

Mark 
currently 
selected 
message  for 
reply,  go  to 
Sys  Main 
Rprts 

n/a 

n/a 

Sys  Main 
Msg  Read 
Window 
Active 

Mark 
displayed 
message  for 
re-use,  go  to 
Sys  Main 
Rprts 

Mark 
currently 
selected 
message  for 
reply,  go  to 
Sys  Main 
Rprts 

n/a 

n/a 

Sys  Main 
Rprt 
Window 
Active 

n/a 

n/a 

Do  not  delete 
entered 
partial 
message.  Go 
to  SYS  MAIN 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


Clear& 

Return 

Selected 

SPOT 

Selected 

MTp 

Selected 

SHOT 

Selected 

Logon 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Address 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

CEOI  / 
Group  List 
Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg  Read 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Rprt 
Window 
Active 

n/a 

Go  to  Spot 
Window 

Go  to  MTO 
Window 

Go  to  SHOT 
window 
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Table  160  Client  State  Transition  Table,  cont 


SPLASH  FREE  TEXT  REOT  MOVCMD 

Selected  Selected  Selected  Selected 


Logon  n/a  n/a  n/a  n/a 

Window 
Active 


Sys  Main 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Address 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

CEOI  / 
Group  List 
Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg  Read 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Rprt 
Window 
Active 

Go  to  SPLASH 
window 

Go  to  FREE 
TEXT  window 

Goto 

REQUEST 

window 

Goto 

MOVCMD 

window 
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Table  160  Client  State  Transition  Table,  cont. 


SND  ROUT 
Selected 

SNO  URG 
Selected 

ADRS 

Selected 

AORS  MORE 
Selected 

Logon 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Address 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

CEOi  / 
Group  List 
Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg  Read 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Rprt 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


Logon 

Window 

Active 


Sys  Main 

Window 

Active 


Address 
List  Edit 
Window 
Active 


Location 
List  Edit 
Window 
Active 


CEO  I  / 

G  •.  list 

Wll.uOW 

Active 


Sys  Main 
Msg 

Window 

Active 


Sys  Main 
Msg  Read 
Window 
Active 


Sys  Main 
Rprt 
Window 
Active 


ENEMY 

TYPE 

Selected 

ENEMY 

ACTIVITY 

Selected 

ENEMY 

ACTIVITY 

MORE 

Selected 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

OIREC 

Selected 
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Table  160  Client  State  Transition  Table,  cont. 


OBS  INT 
selected 

SPEED 

Entered 

NUMBER 

Selected 

UNIT 

Selected 

Logon 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Address 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

CEOI  / 
Group  List 
Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg  Read 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Rprt 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont 


REQ  ADJ  EAT  EOM  TASK 

Selected  Selected  Selected  Selected 


Logon 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Address 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

CEOI  / 
Group  List 
Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg 

Window 

Active 

j 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg  Read 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Rprt 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


TASK  MORE 
Selected 

WHEN 

Selected 

LCTN 

Selected 

LCTN  MORE 
Selected 

Logon 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Address 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

CEOI  / 
Group  List 
Edit 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Msg  Read 
Window 
Active 

n/a 

n/a 

n/a 

n/a 

Sys  Main 
Rprt 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont 


UTM 

Entered 

TIME 

Entered 

FREE  TEXT 
ANNOTATIO 

N  Entered 

Logon 

Window 

Active 

n/a 

n/a 

Sys  Main 

Window 

Active 

n/a 

n/a 

Address 
List  Edit 
Window 
Active 

n/a 

n/a 

Location 
List  Edit 
Window 
Active 

n/a 

n/a 

CEOI  / 
Group  List 
Edit 
Window 
Active 

n/a 

n/a 

Sys  Main 
Msg 

Window 

Active 

n/a 

n/a 

n/a 

Sys  Main 
Msg  Read 
Window 
Active 

n/a 

n/a 

n/a 

Sys  Main 
Rprt 
Window 
Active 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


Logon  to 
Network 
Selected 

Stand  Alone 
Selected 

Sys  Main 
Selected 

Address 

List 

Selected 

liTO 

Window 

Active 

n/a 

n/a 

Go  to  Sys 
Main 

n/a 

SHOT 

Window 

Active 

n/a 

n/a 

Go  to  Sys 
Main 

n/a 

SPLASH 

Window 

Active 

n/a 

n/a 

Go  to  Sys 
Main 

n/a 

MOVCMD 

Window 

Active 

n/a 

n/a 

Go  to  Sys 
Main 

n/a 

REQUEST 

Window 

Active 

n/a 

n/a 

Go  to  Sys 
Main 

n/a 

SPOT 

Window 

Active 

n/a 

n/a 

Go  to  Sys 
Main 

n/a 

FREE  TEXT 
Window 
Active 

n/a 

n/a 

Go  to  Sys 
Main 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


CEOI/ 
Group  List 
Selected 

Location 

List 

Selected 

MSGS 

Selected 

RPRT 

Selected 

MTO 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SHOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPLASH 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

MOVCMD 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

REQUEST 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

FREE  TEXT 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


MTO 

Window 

Active 


SHOT 

Window 

Active 


SPLASH 

Window 

Active 


liOVCMD 

Window 

Active 


REQUEST 

Window 

Active 


SPOT 

Window 

Active 


FREE  TEXT 
Window 
Active 


Up  Selected 

Down 

Selected 

Add 

Selected 

Delete 

Selected 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  com. 


READ  Logout  Prev  Next 

Selected  Selected  Selected  Selected 


MTO 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SHOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPLASH 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

MOVCMD 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

REQUEST 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

FREE  TEXT 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


Re-Use 

Selected 

Reply 

Selected 

Save  &  Exit 
Selected 

Save  &  Return 
Selected 

liTO 

Window 

Active 

n/a 

n/a 

n/a 

Do  not  delete 
entered  partial 
MTO  message.  Go 
to  SYS  MAIN 
RPRTS 

SHOT 

Window 

Active 

n/a 

n/a 

n/a 

Do  not  delete 
entered  partial 
SHOT  message,  Go 
to  SYS  MAIN 
RPRTS 

SPLASH 

Window 

Active 

n/a 

n/a 

n/a 

Do  not  delete 
entered  partial 
SPLASH  message. 
Go  to  SYS  MAIN 
RPRTS 

MOVCMD 

Window 

Active 

n/a 

n/a 

n/a 

Do  not  delete 
entered  partial 
MOVCMD 
message,  Go  to 
SYS  MAIN  RPRTS 

REQUEST 

Window 

Active 

n/a 

n/a 

n/a 

Do  not  delete 
entered  partial 
REQUEST 
message,  go  to 
SYS  MAIN  RPRTS 

SPOT 

Window 

Active 

n/a 

n/a 

n/a 

Do  not  delete 
entered  partial 
SPOT  message;  Go 
to  SYS  MAIN 
RPRTS 

FREE  TEXT 
Window 
Active 

n/a 

n/a 

n/a 

Do  not  delete 
entered  partial 
FREE  TEXT 
message.  Go  to 
SYS  MAIN  RPRTS 
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Table  160  Client  State  Transition  Table,  cont. 


Clear& 

Return 

Selected 

SPOT 

Selected 

MTO 

Selected 

SHOT 

Selected 

MTO 

Window 

Active 

Delete  entered 
partial  message. 
Go  to  SYS  MAIN 
RPRTS 

n/a 

n/a 

n/a 

SHOT 

Window 

Active 

Delete  entered 
partial  SHOT 
message.  Go  to 
SYS  MAIN 
RPRTS 

n/a 

n/a 

n/a 

SPLASH 

Window 

Active 

Delete  entered 
partial  SPLASH 
message,  Go  to 
SYS  MAIN 
RPRTS 

n/a 

n/a 

n/a 

MOVCMD 

Window 

Active 

Delete  entered 
partial  MOVCMD 
message.  Go  to 
SYS  MAIN 
RPRTS 

n/a 

n/a 

n/a 

REQUEST 

Window 

Active 

Delete  entered 
partial  REQUEST 
message,  go  to 
SYS  MAIN 
RPRTS 

n/a 

n/a 

n/a 

SPOT 

Window 

Active 

Delete  entered 
partial  SPOT 
message,  go  to 
SYS  MAIN 
RPRTS 

n/a 

n/a 

n/a 

FREE  TEXT 
Window 
Active 

Delete  entered 
partial  FREE 
TEXT  message. 
Go  to  SYS  MAIN 
RPRTS 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


SPLASH 

Selected 

FREE  TEXT 
Selected 

REQT 

Selected 

MOVCMD 

Selected 

MTO 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SHOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPLASH 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

MOVCMD 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

REQUEST 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

FREE  TEXT 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


SNO  ROUT 
Selected 

SNO  UR6 
Selected 

ADRS 

Selected 

ADRS  MORE 
Selected 

MTO 

Window 

Active 

Send  MTO 
Report 
ROUTINE,  Go 
to  SYS  MAIN 
RPRTS 

Send  MTO 
Report 
URGENT,  Go 
to  SYS  MAIN 
RPRTS 

Round-Robin 
the  ADRS 
highlight 

Toggle 

alternate 

address 

selections 

SHOT 

Window 

Active 

Send  SHOT 
Report 
ROUTINE,  Go 
to  SYS  MAIN 
RPRTS 

Send  SHOT 
Report 
URGENT,  Go 
to  SYS  MAIN 
RPRTS 

Round-Robin 
the  ADRS 
highlight 

Toggle 

alternate 

address 

selections 

SPLASH 

Window 

Active 

Send  SPLASH 
Report 
ROUTINE,  Go 
to  SYS  MAIN 
RPRTS 

Send  SPLASH 
Report 
URGENT,  Go 
to  SYS  MAIN 
RPRTS 

Round-Robin 
the  ADRS 
highlight 

Toggle 

alternate 

address 

selections 

MOVCMD 

Window 

Active 

Send 
MOVCMD 
Report 
ROUTINE,  Go 
to  SYS  MAIN 
RPRTS 

Send 

MOVCMD 
Report 
URGENT,  Go 
to  SYS  MAIN 
RPRTS 

Rouhd-Robin 
the  ADRS 
highlight 

Toggle 

alternate 

address 

selections 

REQUEST 

Window 

Active 

Send 

REQUEST 
Report 
ROUTINE,  Go 
to  SYS  MAIN 
RPRTS 

Send 

REQUEST 
Report 
URGENT,  Go 
to  SYS  MAIN 
RPRTS 

Round-Robin 
the  ADRS 
highlight 

Toggle 

alternate 

address 

selections 

SPOT 

Window 

Active 

Send  SPOT 
Report 
ROUTINE,  Go 
to  SYS  MAIN 
RPRTS 

Send  SPOT 
Report 
URGENT,  Go 
to  SYS  MAIN 
RPRTS 

Round-Robin 
the  ADRS 
highlight 

Toggle 

alternate 

address 

selections 

FREE  TEXT 
Window 
Active 

Send  FREE 
TEXT  REPORT 
ROUTINE,  Go 
to  SYS  MAIN 
RPRTS 

Send  FREE 
TEXT  REPORT 
URGENT,  Go 
to  SYS  MAIN 
RPRTS 

Round-Robin 
the  ADRS 
highlight 

Toggle 

alternate 

address 

selections 
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Table  160  Client  State  Transition  Table,  cont 


ENEMY 

ENEMY 

ENEMY 

DIREC 

TYPE 

ACTIVITY 

ACTIVITY 

Selected 

Selected 

Selected 

MORE 

Selected 

MTO 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SHOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPLASH 

WlndP'v 

Active 

n/a 

n/a 

n/a 

n/a 

MOVCMD 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

REQUEST 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPOT 

Window 

Active 

Round-Robin 
the  ENEMY 
TYPE 
highlight 

Round-Robin 

ENEMY 

ACTIVITY 

highlight 

Toggle  ENEMY 
ACTIVITY 
selections 

Round-Robin 

the 

DIRECTION 

highlight 

FREE  TEXT 
Window 
Active 

n/a 

n/a 

' 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 

OBS  INI  SPEED  NUMBER  UNIT 

selected  Entered  Selected  Selected 


MTO  n/a  n/a  n/a  n/a 

Window 
Active 


SHOT  n/a  n/a  n/a  n/a 

Window 
Active 


SPLASH 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

MOVCMD 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

REQUEST 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPOT 

Window 

Active 

Round-Robin 

OBSERVER 

INTENT 

highlight 

Capture 
SPEED  Text 

Capture 
NUMBER  Text 

Capture  UNIT 
Text 

FREE  TEXT 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


REQ  AOJ 
Selected 

EAT 

Selected 

EOM 

Selected 

TASK 

Selected 

MTO 

Window 

Active 

Set  MTO 
message  type 
to  REQ  AOJ 

Set  MTO 
message  type 
to  Enter  As 
Target 

Set  MTO 
message  type 
to  End  of 
Mission 

n/a 

SHOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPLASH 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

liOVCMD 

Window 

Active 

n/a 

n/a 

n/a 

Round-Robin 

TASK 

highlight 

REQUEST 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

FREE  TEXT 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


TASK  MORE  WHEN  LCTN  LCTN  MORE 

Selected  Selected  Selected  Selected 


MTO 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SHOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

SPLASH 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

MOVCMD 

Window 

Active 

Toggle  TASK 
selections 

Round-Robin 

TASK 

selections 

Round-Robin 

LCTN 

highlight 

Toggle  LCTN 
selections 

REQUEST 

Window 

'  Active 

1 

n/a 

n/a 

n/a 

n/a 

SPOT 

Window 

Active 

n/a 

n/a 

n/a 

n/a 

FREE  TEXT 
Window 
Active 

n/a 

n/a 

n/a 

n/a 
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Table  160  Client  State  Transition  Table,  cont. 


UTM 

Entered 

TIME 

Entered 

.  FREE  TEXT 
ANNOTATIO 

N  Entered 

MTO 

Window 

Active 

n/a 

n/a 

Capture  FREE 
TEXT 

Annotation 

SHOT 

Window 

Active 

n/a 

n/a 

Capture  FREE 
TEXT 

Annotation 

SPLASH 

Window 

Active 

n/a 

n/a 

Capture  FREE 
TEXT 

Annotation 

MOVCMD 

Window 

Active 

Capture 

UTfis 

Capture 
TIME,  change 
to  ZULU  if 
entered  in 
LOCAL 

Capture  FREE 
TEXT 

Annotation 

REQUEST 

Window 

Active 

n/a 

n/a 

Capture  FREE 
TEXT 

Annotation 

SPOT 

Window 

Active 

n/a 

n/a 

Capture  FREE 
TEXT 

Annotation 

FREE  TEXT 
Window 
Active 

n/a 

n/a 

Capture  FREE 
TEXT 

Annotation 
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40.  Appendix  D  •  DMCC  Protocol  Data  Units  (PDUs). 

The  diagrams  on  the  following  pages  graphically  detail  the  message  protocol 
data  units  used  by  the  Digital  Message  Communications  System.  The  DMCC 
software  is  capable  of  building,  transmitting,  receiving,  deco^g  and  displaying 
the  SPOT,  MTO,  SHOT,  SPLASH,  REQUEST,  MOVCMD,  and  FREE  TEXT 
message  PDUs.  In  addition,  it  is  capable  of  receiving,  decoding  and  displaying 
the  BDA,  RECON,  ARTILLERY  REPEAT,  ARTILLERY  CANCEL,  ARTILLERY 
CNO  ARTILLERY  SHIFT,  ARTILLERY  NEW  MISSION,  ARTILLERY  END 
MISSION,  STATUS,  NBC,  PBREP,  DNAV  and  MIJI  message  PDUs. 
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40.2  DIS  Header  and  Common  Block 

lA  DMC  (SIGNAL)  PDU:  DIS  i»#v  oat#:  . 

I  aii  aM'.tiiv)  m* 

twfcte  r  «  »t  aM-.MMii 


H«adtr.An<LXommon  (240): 


9  ^ 

A  mM 

s 

MV 

j  A^at 


Hgure  22  Simnet  PDU  Header  &  Common 
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40.3  BDA  PDU  Specific 


03  Subtype  =  BDA 
00  Variation  =  Standard 

0  Not  EnloTM 

1  untnewn 

2  ADA 

3 

4  Tank 

5  VMtId 

6  TfkO 

7  Aeft 
6  TfM 

4  Unci 


Specific  (40); 


StriktTimt 
Start  (16) 

(Sot  OTG  Tyet) 

StrikfTime 
End  06) 

(StoOTG  Tyot) 

TargttCattgory (i) 

TargttTyot  ( 1 ; 

TKgots 
Oostroyod  (2) 

Paretnt 
Covtrage ( i : 

unustd(3l 

Rev.  Date; 
i 2/ 1 6/92 


ifSkMn 

B  •  Bytts  (Mfault  If  not  sotcifioo) 
b  •  bits 

all  vaiuaa  aotciriao  m  noa 
rioios  ara  unsigned  if  not  soocified 


0  NotEnttroc 

1  OX 

2  29X 

3  SOX 

4  7SX 

5  lOOX 


TOTAL  SIZE  ■  240  •»  40  ■  280  Bytes  (includes  Header  &  Common  Block) 
Figure  23  Battle  Damage  PDU  Specific 
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40  A  MOVCMO  PDU  Specific 


D  C  DMC  PDU  Specific: 

06  Subtype  =  MOVE  o 

00  Variation  =  Standard  I 


LCeCNO 

S  •  Sytts  (dtfault  if  net  fpecirieo) 

b  •  Ditf 

•11  vaKiet  •eecifiM  in  nex  . 
fields  arc  unsigned )( net  seecif led 


Specific  (48); 


TargetlOdS 

( 16  cnaracter  striiu 

Task  ( 1 ) 

Who (1) 

wntn(i) 

unused  (3) 

Zulu  Tune  <2 

Minutes  ancsd  of  Zul 

wnere  (6) 

(8  Cnaracter  String 

OTGdSI 

(See  0T6  Tyee) 

Net  Entered 
MOV  TO 
HOLD  AT 
CONTnSN 
nCM>Z  AT 
ENOAfiE  TOT  AT 
rtVNO  TO 
l«.D«  AT 
ADVINO  AT 
PSN6TNRU 
oCPOTNoraon 


0  Net  Entered 

1  ME 

2  YOU 

_  3  SEE  BELOW 

0  NetEnteret 

1  immed 

2  wnnMT 

3  AMC 
A  DT6 

Rev.  Date: 
3/16/93 


TOTAL  SIZE  -  240  ♦  48  -  288  Bytes  (inc)udes  Header  &  Common  Block) 


Figure  24  MOVCMD  PDU  Specific 
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40.5  M I JI  PDU  Specific: 


D  C  DMC  PDU  Specific: 

0  A  Subtype  =  MIJI 
00  Variation  =  Standard 


Rev.  Date: 
12/15/92 

B  •  ByMt  (Mrauit  If  not  tetctrito) 

B  •  Bit* 

all  vsiuaa  wBCintd  m  itti 
fitIM  art  unf tgntd  M  not  totcirito 


0  Not  Enttrtd 

1  unknown 

2  inttnntt 


0  Not  Enttrtc 

1  unknown 

2  fltaconmg 

3  intrution 

4  uamniing 

5  inttrftrt 


3  Cont 

4  Imitativt 

5  warBling 

6  Music 

7  Keypad 


TOTAL  SIZE  -  240  ♦  96  •  336  Bytes  (Includes  Header  &  Common  Block) 


Figure  25  MQl  PDU  Specific 
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40.6  PIREP  POU  Specific: 


D  C  DMC  PDU  Specific: 
0  B  Subtype  *  PIREP 


00  Variation  =  Standard 

Soectric  (24); 


Z  s.»i  iMe-ea 
2 

3  c^niit 

4  Twantit 


:  \at  I'M 
va'w 

2  -M» 

3 

4  Steer 

5  -a? 

t  Stia<t 

7  «'*44lt 
•  :4el 

9  SiUare 


art  jtnifita  if  tai  aae^ifita 


TOTAL  SIZE  ■  240  *  24  •  264  Bytes  (mctudes  Header  &  Common  Block) 

Figure  26  PIREP  PDU  Specific 
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40.7  RECON  GND  ROUTE  POU  Specific: 


04  Subtype  =  RECON 
00  Variation  =  GND  ROUTE 


Specific  (60):  Subtype.GndRoute 


EntmyActivlty  ( 1 

Claasiricat lo 
Formula  ( 1 ) 

UnuiM  (6) 

ClassForminto  (32 

(32  cnaracttr  string) 

RoutalO  (32) 

(32  cnaracttr  string) 

Ltftovtr  (8) 

0  Not  Cnttrtc 

1  w 

2  Tyot 

3  f«.C 

4  OHC 

5  oe 

6  Block 


Rev.  Date; 
12/03/92 

B  -  Byctt  (otfauii  II  no(  setcirioo) 

D  •  DItl 

all  vaiuos'aiMcif iM  in  nt« 
iialos  art  unsignto  if  not  sotcirito 

0  Not  EnttrtO 

1  Nona 

2  Stationary 

3  Mowing 

4  Dug  in 

5  Attrtating 

6  AAfancing 
^  Attacking 

8  Oamagto 

9  Killto 

A  MoeiltKIII 


Figure  27  Gnd  Route  Recon  PPU  Specific 
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40.8  RECON  AIR  ROUTE  Specific: 


01  Variation  =  AIR  ROUTE 

Specific  (80);  Subtype.AfrRoute 


CncmyActivity  ( I 


OostacIM  (I) 


UnustO  (6) 


ClassForminro  (32  (32  cnaracttr  siring) 
RouteiO  (32)  (32  cnaraciK  string) 

Leflovar  (8) 


>  0  Not  [nttrtc 

1  Nona 

2  Kayoao 

3  AOA 

4  Towr  Ant 

5  iNiras 

6  Tarr 

7  Traas 

8  Bldg 

9  Otnar 


0  Not  Entarad 

1  Nona 

2  Stationary 

3  Moving 

4  Dug  in 

5  Ratraating 

6  Advancing 

7  Attacking 

8  Oamagod 

9  KlllOd 

A  MOOIIaKIII 


Rev.  Date; 
12/03/92 

1  FfiFtd) 

B  •  Bytos  (dafault  if  not  soacif  lao) 
0  -  oils 

all  valuas  soaciriad  m  nan 
(•aids  ara  laisignad  •(  not  soacifiao 


Figure  28  Air  Route  Recon  PDU  Specific 
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40.9  RECON  Bridge  Specific; 

02  Variation  =  BRIDGE 

Specific  (80):  Subtype  'Iridge 


Type  ( 1 ) 

Damage  (2) 

Spans  < 1 ) 

Constmateriai  ( i 

Unused  (4) 

(4  cnaracter  string) 

Length  (4) 

(4  cnaracter  string) 

Width  (4) 

(4  Character  string) 

Heigtn  (4) 

<4  Character  string) 

under (4) 

(4  cnaracter  string) 

ConscrOescr  (16) 

(16  cnaracter  string) 

10(32) 

(32  cnaracter  string) 

Soancengtn  (4) 

(4  Character  string) 

LoadCiass (4; 

(4  Character  string) 

0  Not  Entortc 

1  unknown 

2  Koyoad 

3  nctai 

4  Stone 

5  Concrete 


0  Not  Entereo 

1  None 

2  Li«nt 

3  notserste 

4  Severe 

5  Oestroyeo 


0  NotEntcreo 

1  unknown 

2  Truss 

3  Giroer 

4  Beini 

5  Slao 

6  CLOS 

7  Aren  Op 

8  Susoen 

9  Flotng 
A  Swing 


Rev.  Date: 
12/03/92 

I  fotha 

B  •  Bytes  (oersult  if  net  specitietl) 
D  •  bits 

all  values  specirieo  in  nex 
fields  are  unsigned  if  not  specified 


Figure  29  Bridge  Recon  PDU  Specific 
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40.10  RECON  LZ/PZ  PDU  Specific 


D  C  DMC  PDU  Specific; 
04  Subtype  =  RECON 
03  Variation  =  L2_PZ 

Specific  (80):  Subtype.LZ_PZ 


0  Not  Enttrea 

1  None 

2  Keyoad 

3  AOA 

4  Towr  Ant 

5  Wires 

6  Terr 

7  Trees 
3  Blog 
9  Other 


ActivityLikely  ( I 

Obstacles  ( 1 1 

unused (6) 

Obstacles 
Oescr (16) 

(16  character  string) 

to  (ifil 

( 1 6  character  string) 

LZ.Size  ( 16) 

(16  cnaracter  string) 

Axis  ( 16) 

(16  cnaracter  string) 

Leftover  (8) 

Rev.  Date; 

I  1/23/92 

iFrjuf) 

B  -  Bytes  (default  if  not  soecified) 
b  ‘bus 

all  values  specified  in  nea 
fields  are  unsigned  if  not  specified 

~  0  Not  Entered 

1  None 

2  Expected 

3  Possible 

4  unlikely 


Figure  30  LZ/PZ  Recon  PDU  Specific 


Page  520 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


40.11  RECON  BP-OP  PDU  Specific: 

04  Variation  =  BP^OP 

Specific  (80):  Subtype.BP_OP 


Enemy  Activity  ( 1 

OOStKieS  (  1  ) 

1  None 

-  0  Not  Enterec  j  s„t,onarv 

'  3  Moving 

2  Keyoao  ^ 

unused (6) 

Obstacles 
Oescr (16) 

(16  cnaracter  string: 

^  5  Betreatlng 

4  TowrAnt  j  Aovancin? 

5  Wires  1  Attacking 

‘  8  Damaged 

ID  <  161 

(16  cnaracter  string) 

BP_Size(l6) 

( 16  cnaracter  string) 

AXIS  (16) 

( 16  cnaracter  string) 

Leftover  (S) 

Rev.  Date: 
11/23/92 


I FSfMn 

B  •  Bytes  (Mfiult  If  not  spociritO) 
D  •  Bits 

all  valuoa  lotcifiM  in  htx 
rieiBs  vt  unsigned  ir  not  specified 


Figure  31  BP-OP  Recon  PDU  Specific 
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40.12  RECON  Crossing  PDU  Specific: 

05  Variation  =  CROSSING 

Specific  (60);  Subtype.CrossIng 

Rev.  Date: 
1 1/23/92 


I  fr.Fnr> 

B  •  Byt*s  (dtrtuit  ir  not  seociriod) 

B  •  Bltt 

all  valuta  soaeirttd  in  ntx 
flaws  art  wisignM  if  not  sotciritd 


BanKSIOOtCntry  (4: 

(4  cnaracttr  string) 

BankSlootCxit  (4; 

(4  cnaracttr  string) 

Crossin9Ltn9tn  (4) 

(4cnarKt«r  string) 

Crosaingvfidtn  <4: 

(4  cnaracttr  string) 

CrossingOtotn  (4) 

(4  cnaracttr  string) 

CurrtntFlow  (4) 

(4  cnaracttr  string) 

10(8) 

(8  cnarKttr  string) 

Ltftovtr  (32) 

Figure  32  (Zrossing  Recon  PDU  Specific 
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40.13  ACK  PDU  Specific 

D  C  DMC  PDU  Specific: 

01  Subtype  =  ACK 
00  Variation  =  Standard 


Rev.  Date: 
12/03/92 


B  -  Bytts  (default  ir  not  setetf  lad) 
6  •  Bits 

all  values  soecified  in  ne« 
fields  are  unsigned  if  not  seecified 


Specific  (48): 


Original 
SenderlO  (6) 

Site  (2: 

Hose (2) 

Entity  <2: 

OriginalSender 
Terminal  ( I ) 

OriginalSende 
Person  ( i ) 

A€Knowie09tlO  <6 

Site  (2: 

Host (2) 

Entity  (2; 

AcKnow  ledge 
Terminal  ( 1) 

Acknowledge 
Person ( i ) 

Original 
SenderCEiO  (6) 

<6  enaracter  string) 

Acknowledge 
CEIO  (6) 

(8  enaracter  strin< 

OrigmalOTGdB: 

(See  0T6  Tyee) 

TOTAL  SIZE  -  240  48  -  288  Bytes  (includes  Header  &  Common  Block) 

Figure  33  Acknowledge  PDU  Sp>ecific 
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40.14  SPOT  PDU  Specific 

D  C  DhC  PDU  Specific: 

02  Subtype  =  SPOT 
00  Variation  =  Standard 

Specific  (88): 


TimtSignttO  ( I6 

(Sot  OTG  Tyot) 

Oettrvtr 
Location  (16) 

(Sot  UTM  Tyot) 

Targtt0uantity(2) 

ODStrv  tr 
intentions  ( i) 

TargttTyot  ( 1 : 

TargttActivity  ( I 

TargttOirtction  ( 1 

TargtlSettd  (2) 

(Sot  Sottd  Tyot) 

Targtt 

Location  (16) 

(Sot  UTH  Type) 

Targttunit  ( 16) 

( 16  enaraettr  string) 

unuMd(l6) 

Rev.  Date: 
12/03/92 


0  Not  Enttrtd 

1  OtMT 

2  Cent  ran 

3  Enga 

4  Hid 

5  Rtt  Iheld 

6  Oesv  Tgt 


0  Not  Enttrtd 

1  unknown 

2  AOA 

3  SMI 

4  Tank 

5  wntd 

6  Trkd 
T  ACft 

8  Trot 

9  unci 


— j  nPH  j  vaiut  j  SgatdTyM 

ID  ISD 
LEGE  NO 

S  •  Bytts  (dttault  if  not  totcif ltd) 
D  •  Dtt$ 

all  vaiuts  SDtciritd  in  non 
fitids  art  imigntd  if  not  sptclfitd 


»0 

1 

Not  Enttreo 
None 

0  Not  Enttrtc 

2 

stationary 

1  N 

3 

noving 

2  NE 

4 

Dug  in 

3  E 

S 

Rttrtating 

4  SE 

6 

Aovonctng 

S  5 

7 

Attacking 

6  S  W 

8 

Damaged 

7  W 

9 

Killed 

8  N  W 

10 

raoiieKiii 

9  Unknown 

Figure  34  Acknowledge  PDU  Specific 
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40.16  NBC-4  PDU  Specific 

09  Subtype  =  NBC 
03  Variation  =  NBC-4 

Specific  (64):  Subtype.NBC_2 

0«tCriOt  ion  (  I)  mmtmmmmmmm 

6urstTyD0<l) 

OolivtrtdBy  (I) 

CIOUOHtUnitS  (  I  I  0 


March  31, 1993 


Cloudwidtn  (4)  in  Mfroos  (32D  f  loM) 
CloudO«ser(l6)  (16  enaraettr  otrinf) 

CiooaMiiyxt  (21 _ 

Oosoflatt  (2) 


Loriovtr  (32) 


0  NMCntorod 

1  OtfroM 

2  Ht  in  Ft 

3  Ht  in  n 


Rev.  Date: 
1 1/30/92 


>  0  Not  Enlorod 

1  unknown 

2  Arty 

3  nortar 

4  Docatt 

5  mail  la 

6  Bomo 


0  Not  Cntorco 

1  Nona 

2  unknown 

3  SiTtaco 

4  AW 

5  6nd 


>  0  Not  Entaroo 

1  unusual 

2  initial 

3  incraaamg 

4  Oocroatiitg 

5  Paao 

6  Soaciai 

7  Sorias 

8  varirication 

9  Sianmary 


UfiGtt 

B  •  Bytas  (dorauit  if  not  soaciriad) 
6  •  DItS 

all  vaiuos  soacifiao  m  na> 
fiaios  ara  laisitnad  if  not  soacifiao 


Figure  36  NBC-4  PDU  Specific 
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40.17  NBC-5  PDU  Specific 


09  Subtype  =  NBC 
04  Variation  =  NBC-5 


Specific  (64):  Subtype.NBC-NegatIve 

OMcriDtion  ( t )  L_i._ 

BurstTyoed)  |  ■  "" 

0*1  iv«rf aBy  ( I )  L_iaa 


CloudHtUnitl  ( I ) 


Cioudwiatn  <4)  in  atgrta*  (32s  float) 
ClouaOascr  ( 161  ( 1 6  cnaracttr  itnng) 
ClouaHaignt  (2) 

Ltftovtr  (3B) 


0  Not  Enttrta 

.  ,  I  unusual 

.0  NotEntarta  j 


'  0  Not  Entaraa 

1  Oafraas 

2  Ht  in  f  i 

3  Ht  inn 


Rev.  Date: 
1 t/30/92 


.0  NotEntarta  2  unanown 

1  unknown  j  5^,,^ 

2  4  Air 

3  nartar  5  6^ 

4  Aockat 

5  matlla 


3  incraaaina 

4  Oacraaamt 

5  Paaa 

6  Soacial 

7  Sanaa 

S  varirieation 
9  Summary 


B  •  Bytaa  (aafauit  if  not  spacif ita) 
0  •  Bits 

all  yaluaa  taaclf  laa  m  nai 
fiaias  art  unsignaa  if  not  tpacif  laa 


Figure  37  NBC-5  PDU  Specific 
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40.18  ARTILLERY  REPEAT  PDU  Specific 

D  C  DMC  PDU  Specific: 

05  Subtype  =  ARTY 
00  Variation  =  REPEAT 

Specific  (56);  Subtype.Repeat 

Figure  38  Artillery  Repeat  PDU  Specific 

40.19  ARTILLERY  CANCEL  PDU  Specific 

D  C  DMC  PDU  Specific: 

05  Subtype  =  ARTY 

01  Variation  =  CANCEL  PCV.  Date;  ^  *  Byt**  ir  not  SMoritt 

I  I  /oe 6*  Bill 

Specific  (56);  Subtype.Cancel  '  ‘'23/92  all  valuta  tatcif  ito  m  iwm 

fitlot  art  unaignto  if  not  totcif i< 

Figure  39  Artillery  Cancel  PDU  Specific 

40.20  ARTILLERY  CHECK  PDU  Specific 

D  C  DMC  PDU  Specific; 

05  Subtype  =  ARTY 

02  Variation  ~  CHECK  Rtv. Date;  sfH** ****'''** 

Specific  (56):  SuBtype.CheckFIrt  11/25/92 

fitloa  art  ttiaignM  If  not  aptcirte 

Figure  40  Artillery  Check  PDU  Specific 


Rev.  Date:  ^  *  ‘*‘'‘**  ‘^tfauit  ir  net  aptcintBi 

1 1 /25/92  all  valuta  aetcif  ito  m  nta 

fitlds  art  unaignto  if  not  aotcifito 


40.2 1  ARTILLERT  CNO  PDU  SpeciTic 


D  C  DMC  PDU  Specific: 
05  Subtype  =  ARTY 
03  Variation  =  CNO 

Specific  (56);  Subtype.CNO 


Rev.  Date: 
1 1/25/92 


I  Fr.aK) 

B  •  Bytta  (otfault  if  not  aptcifitt 
b  •  Dita 

all  valuta  aptcif  ltd  in  nta 
ritioa  art  unaignto  ir  net  aetcirie 


Figure  41  Artillery  CNO  PDU  Specific 
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40.22  ARTILLERY  SHIFT  PDU  Specific 

D  C  DMC  PDU  Specific: 

05  Subtype  =  ARTY 

04  Variation  =  SHIFT 

Specific  (56):  Subtype.ShIft  Rev.  Date; 

11/25/92 


>  0  NotEMtrM 
I  DtOuMtM 

0  FAtKdSfF)  2  R<My 
I  m*(ON>  j  Shot 
4  SOIOMi 


Figure  42  Artillery  Shift  PDU  Specific 

40.23  ARTILLERY  SHOT  PDU  Specific 

D  C  DMC  PDU  Specific: 

05  Subtype  =  ARTY 
07  Variation  =  SHOT 

Specific  (56):  Subtype.Shot 

Figure  43  Artillery  Shot  PDU  Specific 


nistoniO  ( 16) 

(iBcnoracttr  strinf) 

TargttIO  ( I6) 

( 16  cnaracttr  string) 

FiissionStatus  (1) 

Firtfor£fttet<i) 

unustd (7) 

ntssagt  ( I6) 

( 16  cnaracttr  string) 

B  •  BytM  (atttult  ir  net  seecitiet 
e  •  Bits 

all  valuta  sotcif  itB  m  htx 
riaioa  art  unstfntB  ir  not  spocifii 
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40.24  ARTILLERY  SPLASH  PDU  Specific 

D  C  DMC  PDU  Specific: 

05  Subtype  =  ARTY 

08  Variation  =  SPLASH 

Specific  (56):  Subtype.Splash  p  p.  . 


liiSioniO  ( 16) 

(16  cnracter  string) 

1 1/25/92 

Targtuo  (16) 

(16  cnracter  string) 

rnstionStatus  ( i ) 

■  rr.e>m  ' 

B ‘Bytes (default  If  net  soeciried)  ???*?' 

o»bits  ^ 

all  values  ssecif  led  in  nex  *  Soiasn 

fields  are  unsigned  if  not  soecif  led 

RoundsFired  ( 1 1 

imoaetTime  (t) 

m  seconos 

unused  (S) 

Leftover  ( I6) 

Figure  44  Artillery  Splash  PDU  Specific 


40.23  ARTILLERY  EOM  PDU  Specific 


DC  DMC  PDU  Specific; 

05  Subtype  =  ARTY 
09  Variation  =  EOM 

Specific  (56):  Subtype.EndofMIsslon 

1 1/25/92 


0  Not  EnitrM 
I  Given 

0  false 

I  TRUE 


MisioniO  ( 16) 

(16  cnaractr  string) 

TargetIO  (16) 

( 1 6  enraetr  string) 

mssionstatus  ( i ) 

Disposition  ( 1 ) 

Casualties  (1) 

RecordTrget  ( i ) 

CasualtyNumber  (2 

unused  (2) 

PointNumbr  (16) 

( 1 6  enr  actr  string) 

I  FfifUi 

B  •  Bytes  (derauit  if  not  soectriet 
b  •  bits 

sii  vsiues  soecirieo  in  nex 
rieios  re  unsigned  tr  net  soecirif 


0  Not  Entree 

1  Bming 

2  CNO 


0  Not  Entree 

1  Requested 

2  Ready 

3  Snot 

4  Soiasn 


Figure  45  Artillery  EOM  PDU  Specific 
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40.26  STATUS  PDU  Speeirie 


D  C  DMC  PDU  Specific: 

07  Subtype  =  STATUS 
00  Variation  =  Standard 


Specific  (16): 


Fuel ( 1 

in  IDS 

Elements  ( i ) 

FaiiedEquip  (3 

(array  of  3) 

Hellfires  (1 

Stingers ( i) 

ROC  lefts  (11 

Rounos ( 1 1 

ReoueslType ( I ) 

unused (S) 

Rev.  Date; 
1 1/23/92 


0  standard 
I  Automatic 


'  0  Not  Entortd 
■  Engl 

2  Eng2 

3  Gtait 

4  Radio 

5  Dgntr 

6  RKtOOd 

7  MSI  Sin 

8  Radar 

9  tasor 


I  rr^MTi 

B  •  Bytas  idafault  ir  not  specif  ltd) 
0  •  Pits 

all  values  specified  in  nea 
fields  are  unsigned  if  not  specified 


TOTAL  SIZE  -  240  ♦IS  -  256  Bytes  (Includes  Header  &  Common  Block) 
Figure  46  Artillery  Status  PDU  Specific 
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40.27  REQUEST  PDU  SpacVle 

D  C  DMC  PDU  Specific: 

08  Subtype  =  REQUEST 
00  Variation  =  Standard 

Specific  (0): 

0  N«t  Ent«r*d 

1  Status 

2  soot 

3  Rscsn 

4  novtmsnt 

5  Pirto 

6  null 


TOTAL  SIZE  -  240  ♦  8  -  248  Bytes  (includes  Header  &  Common  Block) 


Figure  47  Artillery  Request  PDU  Specific 


4  L2/P2 

5  BP/OP 

6  Crossing 
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40.28  DNAV  PDU  Specific 

D  C  DMC  PDU  Specific:  Rev.  Date: 

OC  Subtype  =  DNAV  "'23/92 

00  Variation  =  Standard  ^ 

B  •  Bytts  (M'aull  If  not  soocirioo) 
o«oit$ 

e  I  #4  #a\  *11  y»lut»  opoclf ltd  in  no* 

5peCirtC  (8):  tioios  VO  unoignto  If  not  seociriod 


0  NolEntorod 

1  unknown 

2  RAH66 

3  AM64 

4  OH56 

5  AHI 

6  UHI 

7  CM47 
B  OVI 
9  0H6 
A  CHS4 
B  UH60 
C  RPV 

total  size  *  240  ♦  8  -  248  Bytes  (includes  Header  &  Common  Block) 

Figure  48  DNAV  PDU  Specific 


4  KIA 

5  POW 
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40.29  FREE  TEXT  PDU  Specific 


D  C  DMC  PDU  Specific: 

0  D  Subtype  =  FREE  TEXT 
00  Variation  =  Standard 

Specific  (256); 

r"reeText(256)"TT256T:araet*rTtrtngr"”'"'”1 


Rev.  Date; 

1 1/23/92 

I  pr.Fun 

B  -  Bytts  (default  ir  not  soeciriad) 
0  -  Dits 

all  valuta  specif  ltd  m  hex 
fields  are  unsigned  if  not  specified 


total  size  =  240  ♦  256  =  496  Bytes  (includes  Header  &  Common  Block) 

Figure  49  Free  Text  PDU  Specific 
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5  0 .  Appendix  E  >  DMCC  Functional  Development  Tests. 

The  following  pages  detail  the  functional  development  tests  which  were  used  to 
verify  proper  operation  of  the  DMCC  software.  These  tests  fall  into  several 
categories  as  noted  here: 

Developmental  Thread  Tests 

1.  Stand  Alone  IPC  Thread  Test 

2.  Dual  Client  Stand  Alone  Thread  Test 

Transmission  and  Reception  Tests 

3.  Transmitted  PDU  Content  Accuracy  Test 

4.  PDU  Reception  Accuracy  Text 

5.  DMCC  X-terminal  Configuration  Test 

6.  Dual  Host,  Dual  Client  SIMNET  Compliance  Test 

User  Interface  Tests: 

7.  Window  Content  Verification  Tests 

8.  Graphical  User  Interface  Window  Navigation  Test 

9.  Re-Use  and  Reply;  Acknowledge  Tests 

10.  Miscellaneous  Functional  Tests 
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Developmental  Thread  Tests 

50.1.  Single  Qient  Stand  Alone  IPC  Thread  Test 


Purpose: 


Verify  operation  of  the  Umx  System  V  Interprocess  Commimication  (IPC) 
elements  in  the  DMCC  software. 


DMCC  SINGLE  CLIENT 
STAND  ALONE 

DEVELOMPMENTAL  THREAD  TEST 

(FREE  TEXT  MESSAGE; 

HARO  COOED  DESTINATION; 

NO  CLIENT  MESSAGE  ARCHIVING  OR  RETRIEVAL) 


Background: 

In  the  Digital  message  Communications  Console  software,  a  message  PDU  is 
created  in  the  client  application  and  transmitted  through  die  outgoing  message 
queue  to  the  concurrent  ETHERNET  TRAhSMlT  PROCESS.  The  TRANSMIT 
PROCESS  then  transmits  the  PDU  on  the  Ethernet.  The  message  is  then  received 
by  the  ETHERNET  RECEIVE  PROCESS,  which  asks  the  MESSAGE  SERVER 
PROCESS  where  to  put  the  message  in  shared  memory.  The  RECEIVE  process 
then  informs  the  CUENT  CHILD  PROCESS  of  the  message's  location  through  a 
message  queue.  The  client  child  forked  by  the  client  then  informs  the  client 
throu^  an  unnamed  pipe  that  a  new  message  has  arrived  for  it  The  client  dien 
retrieves  the  message  from  the  shared  memory  and  archives  it  for  later  retrieval 
and  display. 
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Test  Description: 

This  test  will  simulate  transmission  and  reception  of  a  Digital  Message  Protocol 
Data  Unit  by  one  DMCC  CLIENT  PROCESS.  In  this  developmental  test,  no 
archiving  of  messages  by  the  client  is  done,  and  the  recipient  address  is  hard¬ 
coded  into  the  PDU,  instead  of  being  selectable  by  the  user. 

Acceptance  Criteria: 

A  message  must  be  successfully  transmitted  and  received  aiul  the  received 
Message  must  be  identical  to  the  transmitted  one. 

Test  Procedure: 

1.  Start  the  DMCC  developmental  software  lising  the  START  DMCC 
procedure. 

2.  Select  the  MSGl  window  from  the  MAIN  window. 

3.  Select  the  Free  Text  Message  preparation  window  from  the  MSGl 
window. 

4.  Enter  a  unique  free  text  message  (a  string  of  10  or  20  characters).  Do  not 
select  an  addressee  for  this  message. 

5.  Transmit  the  message  by  clicking  the  mouse  pointer  on  the  SEND  button. 

6.  Observe  that  the  message  is  received  back  from  the  Ethernet  by  the  DMCC 
software. 

7.  Repeat  steps  3  through  6,  above,  for  several  different  length  free  text 

messages:  5  characters,  50  characters,  200  characters,  and  255  characters. 
Allowable  characters  include _ 
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SOJI.  Dual  Qient  Stand  Alone  IPC  Thread  Test 


Purpose: 

Verify  proper  operation  of  the  DMCC  MESSAGE  SERVER  PROCESS. 


Ui 

Z 

a 


o 

UJ 

< 


o 

tn 


DMCC  DUAL  CLIENT 
STAND  ALONE 

DEVELOMPMENTAL  THREAD  TEST 

(FREE  TEXT  rESSAGE; 

OPERATOR  SPECIFIED  DESTINATION; 

FUa  CLIENT  MESSAGE  ARCHIVING  «.  RETRIEVAL) 


Background: 

Each  DMCC  message  contains  at  least  one  but  no  mcne  than  eight  destinations  or 
addresses.  These  destinations  can  take  the  form  of  the  Call  Sign  (CEOI)  of  a 
destination  entity,  or  a  GROUP  NAME  for  a  group  of  DMCC  entities  to  whom 
the  digital  message  is  collectively  addressed.  CALL  SIGN  (CEOI)  and 
GROLT  NAMES  are  eight  character  alphanumeric  identifiers. 

However,  in  this  implementation  of  die  DMCC  software,  the  graphical  user 
interface  does  not  allow  for  the  entry  of  more  than  one  simultaneous  address  for 
a  particular  message,  be  it  a  CALL  SIGN  (CEOI)  or  a  GROUP  NAME.  Theottier 
seven  destination  fields  in  the  Protocol  Data  Unit  are  left  blank  (fiUed  with 
zeros). 
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Each  DMCC  Entity  has  a  corresponding  CALL  SIGN  (CEOI),  and,  optionally  a 
list  of  up  to  seven  GROUP  NAMES  to  which  it  "claims"  membership.  More  than 
one  client  may  subscribe  to  messages  in  the  same  group.  In  this  way,  every  client 
which  subscribes  to  a  group  called  TEAM  A"  will  receive  messages  transmitted 
to  that  group  (in  the  same  exercise). 

During  logon  of  a  DMCC  entity,  the  DMCC  CLIENT  PROCESS  requests  a  logon 
from  the  message  server.  The  CLIENT  specifies  to  the  message  server  what  its 
CEOI  is  and  what  groups  to  which  it  belongs,  as  well  as  an  EXERCISE  ID.  The 
CEOI  and  the  GROUP  NAMES  are  eight  character  alphanumeric  strings.  The 
message  server  process  keeps  a  separate  list  of  the  CEOI,  the  GROUP  NAMES 
and  the  Exercise  ID  for  each  client 

In  other  words,  the  message  server  filters  the  messages  according  to  destination 
and  exercise. 

Test  Description: 

This  test  will  evaluate  the  performance  of  the  message  server.  This  process  forms 
the  bridge  between  the  ETHERNET  RECEIVE  PROCESS  and  the  clients.  More 
than  one  client  application  may  be  running  in  the  same  workstation  hardware  at 
the  same  time,  each  corresponding  to  exactly  one  Digital  Message 
Communications  Entity.  The  message  server  receives  a  message  from  the 
ETHERNET  RECEIVE  process  and  sencb  it  to  the  active  client  or  clients  to  which 
it  is  addressed,  and  which  are  operating  in  the  same  exercise  as  the  sending  DMC 
entity. 

Acceptance  Criteria: 

In  this  test,  three  DMCC  entities  (clients)  are  activated,  and  tests  of  sending 
messages  between  them  are  done. 

The  first  test  will  check  to  see  that  a  message  prop>erly  addressed  to  the  target 
Client  and  with  the  proper  Exerdse  ID  is  correctly  handled  by  the  message  server 
and  received  by  the  addressee  client. 

The  third  test  will  check  to  see  that  a  message  improperly  addressed  to  the  target 
Client  but  with  the  correct  Exercise  ID  is  correctly  handl^  by  the  message  server 
and  not  passed  through  shared  memory  to  the  client 

The  second  test  will  check  to  see  that  a  message  properly  addressed  to  the  target 
Client  but  with  the  wrong  Exercise  ID  is  cone^y  hwdled  by  the  message  server 
and  not  passed  through  shared  memory  to  the  client 
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Test  Procedure: 

1.  Start  the  DMCC  software  using  the  START  DMCC  procedure.  Log  a  client 
on  to  the  DMS  using  the  logon  name  “BINKY"  and  the  Exercise  ID  of  1. 

2.  Start  another  client  using  the  START  CLIENT  procedure.  Log  this  client 
into  the  Digital  Message  Server  using  the  logon  name  ’’AKBAR'*  and  an  exercise 
IDof  1. 

3.  Start  a  third  client  using  the  START  CLIENT  procedure.  Log  this  client 
into  the  DMS  using  the  logon  name  "BONGO"  and  the  exercise  ID  of  2. 

4.  Using  the  BINKY  client,  transfer  to  the  ADDRESS  LIST  EDIT  window  and 
add  the  names  "BONGO",  "AKBAR"  and  "JEFF  to  the  list. 


5.  Using  the  AKBAR  client,  transfer  to  the  ADDRESS  LIST  EDIT  window 
and  add  the  names  "BINKY",  "BONGO",  AND  "JEFF 

ADDRESS  LISTS  FOR  THE  TWO  CUENTS  IN  THIS  TEST 


BZHKY  CLZBNT 

AKBAR  CLZBNT 

BONGO  CLZBNT 

BONGO 

BZNKY 

AKBAR 

BONGO 

JBFF 

JBPF 

6.  Using  the  BINKY  client,  transfer  to  the  SPOT  report  window  and  send  a 
spot  report  to  the  AKBAR  client.  Using  the  AKBAR  client,  transfer  to  the  MSG 
screen  and  view  the  received  messages.  The  spot  report  from  the  Binky  client 
should  be  listed  in  the  mailbox.  Select  this  message  and  click  READ  to  read  it. 
You  should  see  the  spot  report  you  sent  from  the  BINKY  client 

7.  Using  the  BINKY  client,  transfer  to  the  Reports  window  send  a  Spot  report  to 
the  address  JEFF. 

8.  Using  the  AKBAR  client,  transfer  to  the  MSG  screen  and  check  to  see 
that  the  second  message  from  the  BINKY  client  was  NOT  received. 

9.  Start  another  client  and  log  on  as  JEFF,  with  Exercise  ID  2.  Go  to  the 
address  list  edit  window  and  enter  the  address  BONGO. 

10.  Using  the  JEFF  client  in  Exercise  2,  send  a  spot  report  to  BONGO. 

11.  Transfer  to  the  BONGO  client  and  check  to  see  that  the  message  from 
JEFF  was  NOT  received  (since  JEFF  is  in  Exercise  2,  and  BONGO  is  in  Exercise 
1.) 
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DMCC  Transmission  and  Reception  Tests 


50  Transmitted  PDU  Content  Accuracy  Test 


Purpose: 


Verify  correct  transmission  of  message  PDUs. 


RECEIVE 


CLIENT 

_ ^ 

CLIENT 

X- 

CHILD 

'  server 

-  i 
^  I 

oc  I 
£1 


ons 


shared 

MEMORV 


TflANSniT 


4  1.1  I  1 


riESSAGE  QUEUE 


SPARC  2  workstation 


0ATAL066ER 


DMCC 

PROTOCOL  DATA  UNIT 
TRANSMISSION  CONTENT  TEST 


(ALL  POUS) 


Bacl^round: 

In  this  implementaaon,  the  Digital  Message  Communications  Console  is  capable 
of  sending  seven  different  kincis  of  messages. 

Test  Description: 

In  this  test,  each  of  the  different  kiitds  of  messages  wiU  be  transmitted  by  the 
DMCC  onto  the  network  and  logged  by  the  Datalogger  for  manual  inspection. 
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Acceptance  Criteria: 

Each  Message  PDU  will  be  examined  fcv  content  correctness. 

Test  Procedure: 

1.  Start  the  DMCC  software  using  the  DMCC  start  procedure. 

2.  Start  a  Client,  and  log  on  to  the  Digital  Message  Server  as  REAGAN,  with 
Exercise  ID  1. 

3.  Start  the  Datalogger  and  set  it  to  capture  Digital  Message  PDUs  only. 

4.  Using  the  REAGAN  client,  send  a  spot  report  to  the  datalogger. 

5.  Send  a  MTO  report  to  the  datalogger. 

6.  Send  a  SHOT  report  to  the  datalogger. 

7.  Send '  SPLASH  report  to  the  datalogger. 

8.  Send  a  REQUEST  report  to  the  datalogger. 

9.  Send  a  MOVCMD  report  to  the  datalogger. 

10.  Send  a  FREE  TEXT  report  to  the  datalogger. 

11.  Stop  the  datalogger. 

12.  Print  out  the  PDUs  which  were  received  by  the  datalogger  from  the 
REAGAN  client. 

13.  Inspect  the  PDUs  received  from  the  REAGAN  DMCC  client  for  content 
correctness.  You  should  see  the  exact  fields  which  you  sent  from  the  DMCC 
for  each  message  type. 
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50.4.  DMCC  PDU  Reception  Accuracy  Test 


Purpose:  To  verify  that  the  DMCC  software  properly  decodes  PDUs  it 

receives  hx)m  the  network. 


Background: 

In  this  implementation,  the  DMCC  software  can  receive,  record,  retrieve  and 
display  28  different  kinds  of  messages,  most  of  which  are  actually  incapable  of 
being  transmitted  by  the  DMCC  itself.  These  are  messages  which  will  (maybe) 
be  transmitted  by  the  simulated  Comanche  helicopter  mission  equipment 
package  software,  and  represent  digital  communications  between  the  helicopter 
aircrew  and  ground  force  elements  and  command  centers. 

Test  Description: 

For  this  test,  the  PDU  Builder  will  be  used  to  manufacture  digital  message  PDUs 
which  will  be  stwed  in  a  file.  These  will  then  be  traitsmitted  onto  the  network  by 
the  Aima  Tool  for  reception,  storage,  and  retrieval  by  a  Digital  Message 
Communications  Console.  The  Message  Read  hmction  of  the  DMCC  will  be 
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used  to  examiitt  the  contents  of  the  received  message,  and  these  contents  will  be 
checked  against  the  PDU. 

Acceptance  Criteria: 

Each  phony  PDU  will  be  constructed  ahead  of  time  and  the  contents  noted. 
These  PDUs  will  be  contained  in  datalogger  PDU  files  which  can  be  read  by  the 
Datalogger  and  transmitted  on  the  net.  As  each  PDU  is  sent  by  the  Datalogger 
and  received  by  the  DMCC,  the  PDU  contents  are  checked  against  the  displayed 
information,  llte  test  will  be  considered  to  be  passed  when  each  type  of  message 
is  correctly  received  aiui  displayed  by  the  DMCC  software. 

Test  Procedure: 

1.  Using  the  PDU  Builder,  prepare  a  set  of  PDU  files  for  each  PDU  type  in 
the  Digital  Message  Protocol.  Vary  the  fields  of  data  between  each  of  the  PDUs 
of  a  particular  type.  Prepare  enough  PDUs  to  fully  test  each  enumerated  type  in 
each  kind  of  PDU.  For  example,  in  the  MOVCMD  PDU,  the  TASK  enumerated 
type  field  contains  11  selections:  Not  Entered,  To,  Hold  Cont  Ms,  Rendez  At, 
Enga  Tgt,  Moving  to,  Hldg  At,  Arrivg  At,  Passg  Thru,  and  Departg  From.  The 
WHO  enumerated  type  field  contains  six  selections,  and  the  WHEN  field 
contains  five.  For  this  example,  11  PDUs  would  need  to  be  prepared,  since  11  is 
the  number  of  selections  in  the  task  with  the  most  selections.  Each  PDU  would 
have  one  of  the  11  selections  for  the  TASK  field.  The  selections  for  the  WHO  and 
WHEN  fields  are  to  be  varied  as  well,  but  some  of  the  selections  will  have  to  be 
used  more  than  once  since  there  are  only  5  selections  and  11  different  PDUs. 

Build  these  PDUs  with  the  DESTINATION  field  set  to  MADONNA,  and  the 
exercise  ID  set  to  1. 

Build  some  of  the  PDUs  of  each  type  with  priority  set  to  URGENT  and  some  set 
to  ROUTINE. 

Build  these  PDUs  with  the  date  time  group  set  to  a  constant  date:  0705  March  3, 
1993. 

2.  Build  a  set  of  12  SPLASH  PDUs  to  test  the  Date  Time  Group  feature,  by 
varying  the  date  field  to  include  each  month.  Vary  the  time  portion  of  the  field 
to  allow  tests  of  0000  hours,  0600, 1159  and  2359  hours.  Vary  the  seconds  field. 
Obviously,  an  exhaustive  test  of  all  combinations  of  time  is  not  practical;  the 
attempt  here  is  to  just  verify  that  the  date  and  time  are  going  thru  for  a 
representative  selection  of  the  possible  cases. 

3.  Usix^  the  PDU  Viewer,  print  the  contents  of  each  PDU  out  on  paper. 

4.  Coimect  the  DMCC  to  SIMNET. 
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5.  Start  the  DMCC  software  using  the  DMCC  Start  Procedure. 

6.  Log  on  a  CLIENT  to  the  digital  message  server  under  the  name 
MADONNA,  using  Exercise  ID  1. 

7.  Set  the  Datalogger  to  log  DMC  PDUs. 

8.  Using  the  Anna  Tool,  transmit  15  PDUs  into  the  DMCC. 

9.  Using  the  DMCC,  transfer  to  the  MSGl  screen,  select  a  PDU  from  the 
Message  List  and  dick  READ. 

10.  Check  the  contents  of  the  message  as  shown  on  the  DMCC  MSG  READ 
window  against  the  known  contents  of  the  PDU  from  the  PDU  Viewer.  For  all 
PDUs,  you  should  notice  no  discrepancies  between  the  message  contents  and 
the  PDU  printout 
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50^  DMCC  X-tenninal  Configuration  Test 


Purpose: 

This  test  confirms  the  DMCC  operates  properly  in  a  dual  client,  single  platform 
environment.  It  involves  two  client  processes,  one  whose  x-server  resides  in  the 
workstation,  and  one  whose  x-server  resides  in  a  X-terminal. 


DMCC 

X-TERMINAL  CONFIGURATION  TEST 

(7  MESSAGE  TYPES  *  ACKNOWLEDGE; 

OPERATOR  SPECIFIED  DESTINATION; 

FUU  CLIENT  MESSAGE  ARCHIVING  4  RETRIEVAL) 


Background: 

The  Digital  Message  Communications  Console  software  operates  in  a 
client/server  X  environment.  Individual  client  applications  interface  with  the 
network  through  the  Digital  Message  Server  and  the  network  interface  software. 
More  than  one  DMCC  ^ent  application  may  be  simultaneously  runni:^  in  one 
workstation.  Individual  DMCC  application  windows  may  be  displayed  on  the 
console  display  of  the  workstation  or  on  X-terminals  connected  through  a  normal 
TCP’IP  Ethernet  to  the  workstation. 

Test  Description: 

This  test  verifies  operation  of  two  client  applications  in  the  workstation  at  the 
same  time,  one  wh^  server  is  resident  in  ^e  workstation  and  one  whose  server 
is  resident  in  a  Wyse  X-terminal. 
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Acceptance  Criteria: 

This  test  is  considered  to  be  passed  if  proper  operation  of  the  send  and  receive 
functions  is  observed  for  each  of  the  two  DMCC  client  entities. 

Test  Procedure: 

1.  Start  the  DMCC  software  in  the  workstation  using  the  DMCC  start  up 
procedure. 

2.  At  the  console  of  the  Workstation,  log  a  client  on  to  the  Digital  Message 
Server  using  the  DMCC  call  sign  SEAHAWK,  and  Exercise  ID  1. 

3.  At  the  X-terminal,  log  a  DMCC  client  onto  the  Digital  Message  Server 
using  the  call  sign  NATE  and  Exercise  ID  1. 

4.  Using  the  X-term  client,  NATE,  send  some  digital  messages  to  the  client 
SEAHAWK.  Verify  that  they  are  received  properly  by  SEAHAWK 

5.  Using  the  Workstation  client,  SEAHAWK,  send  some  various  digital 
messages  to  NATE.  Verify  that  they  are  received  properly  by  NATE. 
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50.6.  Dual  Host  Dual  dent  SIMNET  Compliance  Test 


Purpose: 


The  purpose  of  this  test  is  to  verify  operation  of  the  DMCC  software  in  the 
context  of  separate  host  platforms. 


DMCC  DUAL  HOST  DUAL  CLIENT 
SIMNET  COMPLIANCE  TEST 

(SELECTED  MESSAGE  TYPES; 

OPERATOR  SPECIFIED  DESTINATION; 

FULL  CLIENT  MESSAGE  ARCHIVING  &  RETRIEVAL) 


Background: 

The  DMCC  is  intended  to  be  able  to  provide  simulated  digital  communications 
between  message  entities  (client  applications)  hosted  on  one  machine  or  on 
several  machines  coiuiecte<i  to  the  SIMNET  ETHERNET  or  to  the  Distributed 
Interactive  Simulation  network  via  the  protocol  gateway. 

Test  Description: 

In  this  test,  two  host  platforms  are  used  to  test  message  interoperability  on  the 
actual  SIMNET  network.  The  Datalogger  is  used  to  capture  the  session  for 
playback. 
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User  Interface  Tests 


50.7.  Window  Content  Verification  Test 


Purpose: 

The  purpose  of  this  test  is  to  verify  that  each  window  in  the  DMCC  client 
application  contains  the  widgets  it  needs  to  do  its  job. 


DMCC  MENU  TOPOLOGY 


Background: 


The  Digital  Message  Communications  Console  software  uses  a  OSF/Motif 
Graphical  User  Interface  running  in  a  X-Windows  windowing  environment 
under  SunOS,  Sun  Microsystems  UNIX  operating  system.  The  Graphical  User 
Interface  consists  of  a  niimber  of  Windows  whi^  contain  buttoxis  for  clicking 
with  the  mouse,  areas  for  entry  of  text,  lists  of  luimes,  addresses  and  locations, 
and  graphical  objects  designed  to  simulate  to  some  extent  the  appearance  of  the 
Coixununicatioits  Subsystem  of  the  RAH>66  Comanche  Helicopter  Mission 
Equipment  Package.  These  objects  are  called  WIDGETS  in  the  venuicular  of  the 
OSF/Motif  Graphical  User  Int^ace. 

Acceptance  Criteria: 

This  test  shall  be  deemed  to  have  been  passed  if  all  required  Widgets  are  present 
in  all  of  the  DMCC  GUI  windows. 
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Test  Description: 

This  test  simply  checks  each  of  the  13  screens  in  the  DMCC  GUI  for  the  correct 
widget  content. 

Note: 

It  should  be  noted  that  there  do  exist  graphical  icons  and  features  in  some 
windows  which  do  not  have  functionality  in  the  context  of  the  Digital  Message 
Commimications  Console  software.  The^  are  provided  to  increase  the  level  of 
fidelity  of  the  simulation  of  the  Comanche  Mission  Equipment  Package.  Those 
objects  are  not  included  in  the  Window  Widget  List  in  appendix  WW. 

Test  Procedure: 

1.  Start  the  DMCC  software  using  the  DMCC  start  procedure. 

2.  Examine  the  logon  screen  for  the  proper  widget  content.  The  widget 
content  of  the  logon  saeen  and  the  other  screens  in  the  DMCC  is  found  in  the 
DMCC  Graphical  User  Interface  Widget  Content  List,  which  is  an  appendix  to 
this  document  Check  that  each  widget  identified  in  the  Widget  List  is  present 
in  this  window. 

3.  Log  a  client  on  to  the  Message  Server  under  the  client  name  HOMER  and 
the  exercise  ID  1. 

4.  Examine  the  Sys  Main  screen  for  widget  content 

5.  Transfer  to  the  CEOI/Group  List  window  and  examine  it  for  widget 
content. 

6.  Transfer  back  to  the  Sys  Main  window  then  to  the  Location  List  Window. 
Examine  the  Location  List  Window  for  widget  content 

7.  Transfer  back  to  the  Sys  Main  Window  and  then  transfer  to  the  Address 
List  Window.  Examine  the  Address  list  window  for  widget  content  Enter 
HOMER  cind  click  the  ADD  button. 

8.  Transfer  back  to  the  Sys  Main  Window  and  then  transfer  to  the  MSGS 
window.  Examine  the  MSGS  window  for  widget  content. 

9.  Trai\sfer  to  the  Reports  wiiuiow  axui  exam,  it  for  widget  content 

10.  Transfer  to  the  MID  window  and  examine  it  for  widget  content 
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11.  Transfer  back  to  the  REPORTS  window  and  then  to  the  SHOT  window. 
Examine  the  SHOT  window  for  widget  content. 

12.  Transfer  back  to  the  REPORTS  window  and  then  to  the  SPLASH  window. 
Examine  the  SPLASH  window  for  widget  content. 

13.  Transfer  back  to  the  REPORTS  window  and  then  to  the  MOVCMD 
window.  Examine  the  MOVCMD  window  for  widget  content. 

14.  Traitsfer  back  to  the  REPORTS  window  and  then  to  the  REQUEST 
window.  Examine  the  REQUEST  window  for  widget  content. 

15.  Traiwfer  back  to  the  REPROTS  window  and  then  to  the  SPOT  window. 
Examine  the  SPOT  window  for  widget  content. 

16.  Transfer  back  to  the  REPORTS  window  and  then  to  the  FREE  TEXT 
window.  Examine  the  FREE  TEXT  window  for  widget  content. 

17.  Enter  the  a  free  text  message,  select  HOMER  as  the  addressee,  and  click 
SEND.  This  will  cause  the  client  to  send  the  free  text  message  to  itself,  so  you 
can  select  it  for  viewing. 

18.  Wait  for  5  seconds. 

19.  Click  the  READ  button  to  get  back  to  the  MSG  window.  Select  the 
message  which  was  just  received,  and  press  dick  READ  again. 

20.  Examine  the  READ  window  for  widget  content. 

21.  Click  SYS  MAIN  to  get  back  to  the  SYS  MAIN  window. 

22.  CUck  LOGOFF  to  Log  off. 


Page  551 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


50.8.  Graphical  User  Interface  Window  Navigation  Test 


Purpose 

The  purpose  of  this  test  is  to  ensure  that  all  window  navigation  pathways  exist 
and  are  op)erational. 


Bacl^round 

The  DMCC  uses  a  X-Windowing  system,  with  various  X>Windows  representing 
various  "screens"  or  "menus"  in  the  Comanche  Mission  Equipment  Package. 
Control  is  passed  from  one  window  to  another  upon  certain  actions  by  the  user. 

Acceptance  Criteria 

Acceptance  criteria  for  this  test  are  that  all  window  navigation  pathways  exist 
and  are  operational. 

Test  Description 

This  test  involves  starting  a  DMCC  client  process,  logging  it  on  to  the  Server,  and 
moving  about  the  window  structure  to  verify  each  pathway. 

Test  Procedure 

Start  the  DMCC  using  the  DMCC  Start  Procedure.  Logon  a  client  as  MARGE. 
The  following  paragraphs  describe  pathways  between  windows.  Check  that 
each  pathway  exists  and  is  operational. 

Click  ADDRESS  LIST  and  check  that  control  passes  to  the  ADDRESS  LIST  EDIT 
MENU. 

Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  MENU 
window. 

Click  LOC  LIST  aiul  verify  that  control  passes  to  the  LOCATION  LIST  EDIT 
window. 

Click  SYS  MAIN  and  verify  that  control  passes  to  die  SYS  MAIN  window. 

Click  CEOI/GROUP  LIST  and  verify  that  control  passes  to  the  CEOI/GROUP 
LBT  EDIT  window. 
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Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  window. 
Click  MSGS  and  verify  that  control  passes  to  the  MSGS  window. 

Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  window. 
Click  MSGS  and  verify  that  control  passes  to  the  MSGS  window. 

Click  RPRTS  and  verify  that  control  passes  to  the  RPRTS  window. 

Click  MTO  and  verify  that  control  passes  to  the  MTO  window. 

Click  SAVE  &  RETURN  and  verify  that  control  passes  to  the  RPRTS  window. 
Click  MTO  and  verify  that  control  passes  to  the  MTO  window. 

Click  CLEAR  &  RETURN  and  verify  that  control  passes  to  the  RPRTS  window. 
Click  SHOT  and  verify  that  control  passes  to  the  SHOT  window. 

Click  SAVE  &  RETURN  and  verify  that  control  passes  to  the  RPRTS  window. 
Click  SHOT  and  verify  that  control  passes  to  the  SHOT  window. 

Click  CLEAR  &  RETURN  and  verify  that  control  passes  to  the  RPRTS  window. 
Click  SPLASH  and  verify  that  control  passes  to  the  SPLASH  window. 

Click  SAVE  &  RETURN  and  verify  that  control  passes  to  the  RPRTS  window. 
Click  SPLASH  and  verify  that  control  passes  to  the  SPLASH  window. 

Click  CLEAR  &  RETURN  and  verify  that  control  passes  to  the  RPRTS  window. 
Click  MOVCMD  and  verify  that  control  passes  tot  the  MOVCMD  window. 
Click  SAVE  &  RETURN  and  verify  that  control  passes  to  the  RPRTS  window. 
Click  MOVCMD  and  verify  that  control  passes  to  the  MOVCMD  window. 
Click  CLEAR  &  RETURN  and  verify  that  control  passes  to  the  RPRTS  window. 
Click  REQUEST  and  verify  that  control  passes  to  the  REQUEST  window. 

Click  SAVE  &  RETURN  and  verify  that  control  passes  to  the  RPRTS  window. 
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Click  REQUEST  and  verify  that  control  passes  to  the  REQUEST  window. 

Click  CLEAR  &  RETURN  and  verify  that  control  passes  to  the  RPRT5  window. 
Click  SPOT  and  verify  that  control  passes  to  the  SPOT  window. 

Click  SAVE  &  RETURN  and  verify  that  control  passes  to  the  RPRT5  window. 
Click  SPOT  and  verify  that  control  passes  to  the  SPOT  window. 

Click  CLEAR  &  RETURN  and  verify  that  control  passes  to  the  RPRT5  window. 
Click  FREE  TEXT  and  verify  that  control  passes  to  the  FREE  TEXT  window. 
Click  SAVE  &  RETURN  and  verify  that  control  passes  to  the  RPRT5  window. 
Click  FREE  TEXT  and  verify  that  control  passes  to  die  FREE  TEXT  window. 
Click  CLEAR  &  RETURN  and  verify  that  control  passes  to  the  RPRTS  window. 
Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  window. 
Click  MSGS  and  verify  that  control  passes  to  the  MSGS  window. 

Click  REPORTS  and  verify  that  control  passes  to  the  RPRTS  window. 

Click  MTO  and  verify  that  control  passes  to  die  MTO  window. 

Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  window. 
Click  MSGS  and  verify  that  control  passes  to  the  MSGS  window, 
dick  RPRTS  and  verify  that  control  passes  to  the  RPRTS  window. 

Click  SHOT  and  verify  that  control  passes  to  me  SHOT  window. 

Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  window. 
Click  MSGS  and  verify  that  control  passes  to  the  MSGS  window. 

Click  RPRTS  and  verify  that  control  passes  to  the  RPRTS  window. 

Click  SPLASH  and  verify  diat  control  passes  to  the  SPLASH  window. 

Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  window. 
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Click  MSGS  and  verify  that  control  passes  to  the  MSGS  window. 

Click  RPRTS  and  verify  that  control  passes  to  the  RPRTS  window. 

Click  MOVCMD  and  verify  that  control  passes  to  the  MOVCMD  window. 
Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  window. 
Click  MSGS  and  verify  that  control  passes  to  the  MSGS  window. 

Click  RPRTS  and  verify  that  control  passes  to  the  RPRTS  window. 

Click  REQUEST  and  verify  that  control  passes  to  the  REQUEST  window. 
Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  window. 
Click  MSGS  and  verify  that  control  passes  to  the  MSGS  window. 

Click  RPRTS  and  verify  that  control  passes  to  the  RPRTS  window. 

Click  SPOT  and  verify  that  control  passes  to  the  SPOT  window. 

Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  window. 
Click  MSGS  and  verify  that  control  passes  to  the  MSGS  window. 

Click  RPRTS  and  verity  that  control  passes  to  the  RPRTS  window. 

Click  FREE  TEXT  and  verify  diat  control  passes  to  the  FREE  TEXT  window. 
Click  SYS  MAIN  and  verify  that  control  passes  to  the  SYS  MAIN  window. 
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50.9.  Re-use  and  Reply;  Acknowledge  Tests 


Purpose: 

Verify  proper  operation  of  the  Reuse  (forwarding)  and  Reply  fimctions  in  the 
DMCCCUent. 

Background: 

In  the  Digital  Message  Communications  System,  a  mechanism  is  provided  to 
allow  messages  which  are  received  to  be  forwarded  to  other  DMCC  entities.  This 
is  done  by  allowing  the  operator  to  exit  the  MESSAGES  screen  directly  to  the 
REPORTS  menu,  where  he  can  prepare  another  message  to  accompany  the 
forwarded  message  as  it  is  sent  on. 

The  DMCC  also  allows  the  user  to  REPLY  to  a  message  directly  without  having 
to  select  the  addressee. 

The  DMCC  software  is  sends  an  ACKNOWLEDGE  PDU  to  the  sender  of 
messages  which  are  read  by  the  user.  This  acknowledge  PDU  causes  an 
ACKNOWLEDGE  pop-up  window  to  be  displayed  on  the  sender's  terminal. 

Test  Description: 

This  three  client  test  will  demonstrate  proper  operation  of  die  Re-use  (Forward) 
function  by  sending  a  message  from  one  client  to  a  second  client,  and  then 
having  the  second  client  forward  that  message,  along  with  another  message,  to  a 
third  ^ent. 

Several  REPLY  messages  will  be  sent  as  well. 

Checks  for  proper  transmission  and  reception  of  Acknowledge  PDUs  will  be 
undertaken  as  well. 

Acceptance  Criteria: 

This  test  will  be  deemed  to  have  been  passed  if  messages  are  properly  forwarded 
and  replied  to,  and  if  ACKNOWLEDGE  messages  are  sent  and  received 
correctly. 

Test  Procedure: 

1.  Start  the  DMCC  software  using  the  START  DMCC  procedure. 
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2.  Log  on  to  the  Server  as  TOC. 

3.  In  the  TOC  client,  enter  the  ADDRESS  LIST  EDIT  window  and  add  the 
CEOI  "LEADER"  to  the  list.  Return  to  the  SYS  MAIN  window. 

4.  Start  a  second  client  and  log  it  on  to  the  server  as  SANTA.  Add  the  names 
TOC  and  WINGMAN  to  LEADER'S  address  Ust. 

5.  Start  a  third  client  lumed  WINGMAN. 

6.  Go  back  to  the  TOC  client  and  click  MSGS  to  enter  the  Messages  window. 

7.  Click  RPRTS  to  enter  the  REPORTS  window. 

8.  Click  FREE  TEXT  to  enter  the  FREE  TEXT  window. 

9:  Enter  the  following  free  text  message: 

PROCEED  WAYPT  4  AWAIT  BEGINNING  OF  HF  JAMMING. 

10.  Send  the  message  to  LEADER. 

11.  Now  go  to  the  LEADER  client  and  access  the  message  sent  by  the  TOC 
client. 

12.  Dismiss  the  message  window.  Make  sure  the  message  is  still  highlighted 
in  the  mailbox. 

13.  Oick  REPLY. 

14.  In  the  REPORTS  screen,  select  FREE  TEXT  . 

15.  Go  back  to  the  TOC  client  and  see  if  an  acknowledge  PDU  was  received 
horn  LEADER. 

16.  Go  to  the  LEADER  client  and  enter  the  following  FREE  TEXT  message: 
WILL  COMPLY.  WILL  AWAIT  FRIENDLY  MIJI  ACTIVITY 

16.  Click  Send  Routine. 

17.  Go  to  the  TOC  client  and  verify  that  the  reply  message  has  arrived. 

18.  Go  to  the  mailbox  and  read  the  reply  message. 

19.  Dismiss  the  reply  message. 
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20.  Click  REPLY,  and  go  to  the  FREE  TEXT  REPORT  screen. 

21.  Enter  the  following  free  text  message; 

IGNORE  MEACONING  ON  1022  MHZ 

22.  Click  SEND  URGENT. 

23.  Go  to  the  LEADER  client  and  access  the  message  from  TOC. 

24.  Go  to  TOC  and  see  if  an  ACK  was  received  from  LEADER. 

25.  Go  to  LEADER.  Read  the  message,  then  dismiss  it 

25.  Click  REPLY 

26.  Go  to  free  text  and  enter  the  following  message: 

WILL  AWAIT  JAMMING;  IGNORE  MEACONING 

27.  Click  Send  Routine. 

28.  The  message  from  TOC  should  still  be  highlighted  in  the  mailbox. 

29.  Oick  RE-USE. 

30.  Go  to  Free  Text. 

31 .  Enter  the  following  Free  Text  Message: 

WINGMAN,  PLEASE  SEE  ENCLOSED  AND  COMMENT  ASAP.  STATUS 
OF  RADIOS.  JAMMING  TO  BEGIN  1125. 

32.  Oick  SEND  URGENT. 

33.  Go  to  the  WINGMAN  client  and  see  if  the  messages  arrived.  There 
should  be  the  original  message  from  the  TOC  client,  plus  the  new  one  from 
LEADER. 

34.  Access  and  read  the  messages. 

35.  Go  back  to  LEADER  and  see  if  LEADER  got  ACKS  back  for  EACH  of  the 
two  messages. 
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50.10.  Miscellaneous  Functional  Tests 


Purpxjse: 

The  purpose  of  this  test  is  to  verify  miscellaneous  operational  features  of  the 
Digital  Message  Communications  Console  software.  These  include; 

Message  Deletion 
Client  Death 
Message  Prioritization 
Operator  errors  entering  time 
Curator  errors  entering  UTMs 
Escape  key  handling 
Control  key  handling 

Reception  of  messages  during  report  preparation 
Reception  of  messages  while  an  alert  box  is  active 
Case  insensitivity  of  target  CEOI/Group  Names 
Default  Addressing  for  Reply 
Empty  Message  Send  Handling 


50.11.  Functional  Stress  Tests 


Message  Server  Message  Queue  Overload 

Shared  Memory  Overload 

Client  Message  Queue  Overload 

High  Fan  Out  Messages 

Free  Text  String  Overload 

Free  Text  Aimotation  Overload 

Eight  Client  Test 

Alternate  Group  Name  Message  Routing 
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50.12  Functional  Test..  Window  Widgets 
DMCC  Window  Widget  Content  List 


All  DMCC  windows  contain  the  Free  Text  Held,  simulate  Cockpit  Interactive 
Keyboard  buttons  (left  arrow,  right  arrow,  DEL  and  CLEAR  ALL.  The  following 
paragraphs  detail  the  window  widgets  in  addition  to  these,  for  each  window 
type. 


LOGON  WINDOW: 

LOGON  TO  NETWORK  button 
STAND  ALONE  button 
LOGON  NAME  Text  Field 
EXERCISE  ID  Text  Field 

SYS  MAIN  WINDOW 

ADDRESS  LIST  button 
LOCATION  LIST  button 
CEOI/GROUP  UST  BUTTON 
LOGOUT  BUTTON 
MSGS BUTTON 
RPRT  BUTTON 
SYS  MAIN  BUTTON 

ADDRESS  LIST  EDIT  WINDOW 

Add  button 
Delete  button 
Save  &  Exit  button 
Sys  Main  button 
lip  button 
DOWN  button 
New  Address  Text  Field 
Address  List 

LOCATION  LIST  EDIT  WINDOW 

ADD  button 
DELETE  button 
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SAVE  &  EXIT  button 
SYS  MAIN  button 
UP  button 
DOWN  button 
New  Location  Text  Field 
Location  List 

CEOI/GROUP  LIST  EDIT  WINDOW 

ADD  button 
DELETE  button 
SAVE  &  EXIT  button 
SYS  MAIN  button 
UP  button 
DOWN  button 

NEW  CALL  SIGN  or  GROUP  NAME  text  field 
Group  List 

SYS  MAIN  MSGl  WINDOW 

Message  Queue  List 
PREV  button 
NEXT  button 
RPRT  button 
READ  button 
DELETE  button 
RE  USE  button 
REUSE  &  INCLUDE  button 
REPLY  button 
Envelope  Icon 
Envelope  Icon  Number 
SAVE  &  EXIT  button 

SYS  MAIN  MSG  READ  WINDOW 

READ  button 
DELETE  button 
SYS  MAIN  button 
NEW  MESSAGE  display 

SYS  MAIN  REPORTS  WINDOW 

SPOT  button 
MTO  button 
SHOT  button 
SPLASH  button 
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FREE  TXT  button 
REQT  button 
MO  VCMD  button 
SYS  MAIN  button 

MTO  WINDOW 

ADRS  selection  ribbon  &  button 
REQ  ADJ  button 
EAT  button 
EOM  button 

SAVE  &  RETURN  button 
CLEAR  &  RETURN  button 
SND  *  ROUT  button 
SND*URG  button 

*  Note:  for  the  MTO  window,  the  SND  ROUT  and  SND  URG  buttons  will 
contain  the  text  of  what  kind  of  MTO  message  has  been  selected  for 
transmission.  For  example,  if  the  REQ  ADJ  button  has  been  selected,  die 
buttons  will  say  SND  ROUT  REQ  ADJ  and  SND  URG  REQ  ADJ. 

SHOT  WINDOW 


ADRS  selection  ribbon  &  button 
FREE  TEXT  annotation  held 
SAVE  &  RETURN  button 
CLEAR  &  RETURN  button 
SND  ROUT  button 
SND  URG  button 
SYS  MAIN  button 


SPLASH  WINDOW 

ADRS  selection  ribbon  &  button 
FREE  TEXT  annotation  held 
SAVE  Sc  RETURN  button 
CLEAR  Sc  RETURN  button 
SND  ROUT  button 
SND  URG  button 
SYS  MAIN  button 
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MOVCMD  WINDOW 

TASK  selection  ribbon  &  button 
WHEN  selection  ribbon  &  button 
LCTN  selection  ribbon  &  button 
ADRS  selection  ribbon  &  button 
FREE  TEXT  annotation  field 
SAVE  &  RETURN  button 
CLEAR  &  RETURN  button 
SND  ROUT  button 
SNDURG  button 
SYS  MAIN  button 

REQUEST  WINDOW 

TYPE  selection  ribbon  &  button 
RECON  TYPE  selection  ribbon  &  button 
ADRS  selection  ribbon  &  button 
FREE  TEXT  annotation  field 
SAVE  &  RETURN  button 
CLEAR  &  RETURN  button 
SND  ROUT  button 
SNDURG  button 
SYS  MAIN  button 

SPOT  WINDOW 

ENEMY  TYPE  selection  ribbon 

ENEMY  TYPE  button 

ENEMY  ACTIVITY  selection  ribbon 

DIKEC  seletion  ribbon 

DIRC  button 

OBS INT  selection  field 

OBS  INT  button 

SPEED  text  entry  field 

NUM  text  entry  field 

UNIT  text  entry  field 

FREE  TEXT  ANNOTATION  field 

ADRS  selection  ribbon  &  button 

SAVE  &  RETURN  button 

CLEAR  &  RETURN  button 

SND  ROUT  button 

SND  URG  button 

SYS  MAIN  button 
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FREE  TEXT  WINDOW. 

FULL  FREE  TEXT  Held 
FREE  TEXT  ANNOTATION  field 
ADRS  selection  ribbon  &  button 
SAVE  &  RETURN  button 
CLEAR  &  RETURN  button 
SND  ROUT  button 
SND  URG  button 
SYS  MAIN  button 

REUSE  WINDOW 

ADRS  selection  ribbon  &  button 
FREE  TEXT  annotation  field 
SAVE  &  RETURN  button 
CLEAR  &  RETURN  button 
SND  ROUT  button 
SND  URG  button 
SYS  MAIN  button 
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€  0 .  Appendix  F  -  DMCC  Graphical  User  Interface. 

OPSKATZOnaL  Spbczpzcatzon 
FOR  THB 

AIRMET  DMCC  GRXPBZCAL  USIR  INTBRFXCX  (GUI) 


60.1  Purpose  and  Scope: 

The  AIRNET  Digital  Message  Communications  Console  uses  a  OSF/Motif® 
Graphical  User  Interface  runxung  in  an  X-Windows/UNIX  environment  on  a  Sun 
Microsystems  dedicated  workstation  or  client-server  X-terminal  platform  to 
closely  mimic  the  operation  of  the  messaging  subsystem  of  the  Mission 
Eqmpment  Package  on  the  RAH'66  Comanche  reconnaissance/attack  helicopter. 
This  interface  uses  Motif  Widgets  and  icons  to  effect  the  simulation  of  displays 
and  buttoi\s  on  the  System  Management  Display  (SMD),  Touchscreen  Menu 
Items  (TMI),  and  Cockpit  Interactive  Keyboard  (CIK)  of  the  Mission  Equipment 
Package.  A  mouse  input  device  is  used  to  manipulate  a  mouse  pointer  on  the 
DMCC  workstation  or  X-terminal  display,  and  to  simulate  depressing  cockpit 
switches  through  "clicking"  on  the  screen  icons  which  represent  those  switches. 
This  document  specifies  the  operation  of  this  Graphical  User  Interface  in  the 
context  of  the  overall  DMCC  software  system  specification. 


DMCC  WINDOW  TOPOLOGY 


In  this  document.  Displays,  Switches  and  Icons  are  identified  in  THIS 
COURIER  FONT. 
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60J  General  Description  of  Operation: 


60JL1  Interface  Elements 


The  accessing  of  incoming  messages  and  the  control  of  outgoing  messa^  on  die 
AIRNET  Digital  Message  Communications  Console  (DMCC)  is  accomplished  by 
depressing  simulated  c^pit  Touchscreen  Menu  Items  (TMI),  activation  of  Soft 
Bezel  Switches  (SBSs)  on  the  simulated  System  Management  Display  (SMD), 
aiul  by  entering  information  in  the  simulated  Cockpit  Interactive  Keyboard 
(OK).  The  limited  CIK  will  be  simulated  by  using  die  workstation  keyboard 
with  a  small  window  on  the  DMCC  Console  Display  simulating  die  OK  display. 
The  X-terminal  QWERTY  keyboard  will  be  used  for  entry  of  textual  information. 


60JU2,  Menu  Windows 

Fourteen  menus  will  be  used  by  the  DMCC  GUL 


STS  MUZN  1 

ADDRSSS  LIST  SDZT  1 

MSQ  READ  1 

RFRT  1 

yTTyJ— — i— — 1 

IMOVCMP _ 1 

SHOT 

HTO 
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603  DMCC  Incoming  Message  Control 


60.3.1  Overview 

The  DMCC  provides  a  OiAIL-like  interface  for  the  listing,  access,  forwarding, 
and  acknowledgment  of  incoming  Digital  Message  Communications.  Control  of 
the  incoming  messages  is  accomplish^  ‘’in"  a  number  of  screen  menus  which  are 
described  in  the  sections  covering  the  SYS  MAIN  and  SYS  MAIN  MSG  menu 
pages. 


603.2  Call  Sign 


Each  Digital  Message/Communications  Entity  is  given  a  call  sign  by  its  operator. 


603.3  Groups 


Each  entity  may  optionally  specify  that  it  belongs  to  up  to  7  entity  groups. 


603.4  Addresses 

Each  Message  includes  a  list  of  DMC  entities  (up  to  8  entities,  idmitified  by  their 
call  signs,  and/or  groups,  identified  by  their  group  names)  which  are  the 
addressees  or  target  recipient  entities  or  groups. 


60.3.5  Reception 


Each  DMC  entity  can  receive  only  those  messages  transmitted  to  it;  i.e.,  messages 
which  are  not  addressed  to  its  call  sign  or  to  a  group  of  which  it  is  a  member  are 
ignored  by  the  entity.  No  alert  or  acknowledgment  of  such  messages  occurs. 


603.6  TOC  -  to  •  TOC  Communications 

Thus,  for  TOC  to  TOC  communicatioitt,  the  TOC  which  wants  to  transmit  a 
message  to  the  other  TOC  must  include  that  TOC's  call  sign  (or  the  name  of  a 
group  of  which  the  target  TOC  is  a  memb^)  in  the  list  of  target  recipients. 
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60J.7  Message  Reception 

When  a  digital  message  arrives  at  a  DMC  entity  which  is  addressed  to  that  entity 
or  is  addressed  to  a  group  of  which  that  entity  claims  membership,  then  that 
message  is  received  and  stored  and  an  alert  box  is  displayed  telling  tiKe  origin  of 
the  message  and  its  type  (see  Sys  Main,  below). 


60.3.8  Sender  ID  ic  Time  Stamp 


Each  transmitted  message  is  marked  with  the  CEOI  (Computer  Electronic 
Operations  Ii^tructions)  or  CALL  SIGN  of  the  transmitting  entity  and  the  Date 
Time  Group  which  tells  the  time  of  message  transmission. 


60.3.9  Acknowledge 


Upon  SELECTION  of  a  message,  the  DMCC  will  transmit  an  Acknowledge 
message  to  the  sender,  which  includes  the  DTG  of  the  message.  Acknowledge 
messages  themselves  are  not  acknowledged. 


60.3.10  The  Alert  Box 


An  ALERT  BOX  will  appear  on  the  transmitter's  screen  which  says  "MESSAGE 
ACKNOWLEDGED  BY  <CEOI>".  Note  that  the  acknowledger  ID  is  not  the 
GROUP  to  which  the  message  was  sent,  but  the  individual  CALL  SIGN  of  the 
acknowledger.  This  alert  box  can  then  be  dismissed  by  an  OK  button. 


603.11  Message  Forwarding  (REFUSE): 

When  a  message  is  selected  from  the  MAILBOX,  a  RE-USE  TMI  will  become 
active.  This  switch  will  allow  the  operator  to  tranfer  to  the  REPORTS  menu, 
where  he  will  be  able  to  generate  a  new  message  of  preformatted  or  free-text 
type,  to  be  sent  to  the  forward  recipient  (the  person  the  message  is  being 
forwarded  to)  of  die  original  message,  along  with  the  original  message. 
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603.12  Reply 

When  a  message  is  selected  from  the  MAILBOX,  a  REPLY  TMI  will  become 
active.  This  switch  will  allow  the  operator  to  tranfer  to  the  REPORTS  menu, 
where  he  will  be  able  to  generate  a  new  message  of  preformatted  or  free-text 
type,  to  be  sent  to  the  sender  of  the  original  message.  The  ADRS  bezel  will 
already  have  selected  the  sender  of  the  h»t  message  as  the  addressee  of  the  new 
message  to  be  sent  back. 
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60.4  DMCC  Outgoing  Message  Control  (REPORTS) 


60.4.1  Available  Reports 


Available  reports  shall  be  presented  and  accessed  via  the  soft  bezel  switches.  For 
all  types  of  reports  transmitted  by  the  DMCC,  the  DMCC  shall  append 
information  to  the  report  selected  by  the  operator.  These  items  include:  the 
sender's  identity,  the  Date  Time  Group  (DTG)  telling  the  date  and  time  the 
rep>ort  was  sent,  and  where  the  sending  DMCC  was  when  the  report  was  sent 
(TOC,  F5E,  or  BATTLEMASTER).  Althcmgh  these  pieces  of  infcmnation  shall  not 
be  seen  by  the  operator  of  the  DMCC,  they  shall  appear  on  the  repmrt  received  by 
the  addressee  individual  or  group. 


60.4.2  Reports  Function 


The  REPORTS  function  is  the  means  by  which  the  DMCC  operator  constructs 
and  sends  messages  out  to  other  DMC  entities.  The  MESSAGES  function 
handles  incoming  digital  message  traffic  and  was  discussed  above. 


60.4.3  Accessing  the  Reports  Window 


The  standard  way  of  entering  the  SYS  MAIN  RPRT  menu  is  by  using  the 
REPORTS  soft  bezel.  SYS  MAIN  RPRT  may  be  exited  by  pressing  the  SAVE  4c 
EXIT  TMI.  There  are  pre>formatted  reports,  plus  a  free  text  report  and  a 
•REQUEST  REPORT. 


60.4.4  MenuWundows 


The  following  pages  describe  in  detail  the  operation  of  each  of  the  MENUS 
which  can  appear  in  the  shell  window  widget  resembling  the  RAH-66  SMD, 
TMI  and  OK. 


60.4.5  Individual  Reports  Windows 


In  this  implementation,  seven  report  message  types  will  be  sent  hrom  the  DMCC 
to  the  helicopter  simulation  entities,  includi^. 
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SPOT 

MTO _ 

SHOT 
SPLASH 
RBQOIST 
MOVCMD 
FRll  TEXT 


TYPKS  OP  HSPORTS  TIUM8MXTTBD  Vt  THM  CMCC 


60.4.6  CIKMENU 


The  CIK  allows  the  operator  to  enter  alphanumeric  data  into  the  system,  on 
board  the  actual  Comanche  aircraft.  The  functionality  of  the  CIK  in  the  Digital 
Message/Commimications  Console  will  be  limit^  to  simulation  of  the  ClK's 
display  on  the  screen  of  the  X-terminal,  but  the  entry  of  actual  alphaniuneric 
information  into  the  DMCC  will  take  place  though  the  QWERTY  keyboard  of  the 
X-term.  Four  other  keys  on  the  CIK  are  implemented,  the  left  and  right  arrow, 
the  Enter  key,  and  CLEAR  ALL 


60.4.7  LCXSON 


The  LOGON  menu  will  be  the  inital  menu  seen  by  the  user  upon  starting  the 
DMCC  software.  It  will  prompt  the  user  for  thie  CEOI  (an  eight  character 
alphanumeric  call  sign). 


6  0 .4.7. 1  LOGON  TO  NETWORK 


The  LOGON  TO  NETWORK  SMD  bezel  on  this  screen  will  allow  the  user  to 
logon  to  the  Digital  Message  Communications  System.  The  program  will  wait 
for  a  period  of  time 


60.4.7.2  STAND  ALONE  OPERATION 


This  bezel  will  allow  the  user  to  turn  on  the  DMCC  client  except  that  it  will  not 
transmit  or  receive  messages. 
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60.4.7.3  SYS  MAIN  Window 


After  the  user  has  selected  one  of  the  modes  of  operation,  control  will  pass  back 
to  the  SYS  MAIN  screen. 


60.4.8  ADDRESS  LIST  EDIT 

The  ADDRESS  LIST  is  the  list  of  CALL  SIGNS  and  GROUPS  to  which  the 
operator  can  send  messages  from  the  various  reports  screens. 

60.4.8.1  Call  Signs,  Group  Names 

It  contains  8  possible  CALL  SIGNS  (8  character  alphanumeric  strings)  and 
GROUP  NAMES  (also  8  character  alphanumeric  strings). 

60.4.8.2  Initial  Members 

Initially,  the  list  will  have  no  members.  Up  to  8  members  can  be  added  to  the  list 

60.4.8.3  ADDRESS  LIST 


The  LIST  is  a  round-robin  tabulated  menu  of  the  current  GROUPS  and  CALL 
SIGNS  to  which  the  console  can  send  messages. 


60.4.8.4  Adding  and  Deleting  Addresses 


This  menu  allows  die  operator  to  ADD  and  DELETE  various  CALL  SIGNS  and 
GROUP  NAMES  from  this  list,  using  the  TEXT  WIDGET,  the  ADD  key,  and  die 
DELETE  key. 


60.4.8.5  ADDRESS  TEXT  WIDGET 


The  text  widget  is  used  for  entering  addresses  for  addition  to  the  list 
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60.4.8.6  SIZING 


An  8  character  text  widget  allows  the  entry  of  new  CALL  SIGNS  or  GROUP 
NAMES .  Its  contents  are  cleared  when  the  ADD  function  is  activated. 

60.4.8.7  UP  BUTTON 


The  UP  button  moves  the  highlight  up  the  LIST,  round-robining  to  the  bottom 
when  the  top  is  reached.  If  there  is  0  or  1  CALL  SIGN  or  GROUP  NAME  in  the 
list,  it  does  nothing. 


60.4.8.8  DOWN  BUTTON 


The  DOWN  button  moves  the  highlight  down  the  LIST,  round-robining  to  the 
top  when  the  bottom  is  reached.  5  there  is  0  or  1  CALL  SIGN  or  GROUP  NAME 
in  the  list,  it  does  nothing. 


60.4.8.9  ADD  BUTTON 


The  ADD  button  adds  the  new  CALL  SIGN  or  GROUP  NAME  from  the  TEXT 
WIDGET  to  the  LIST  which  is  displayed  in  the  round-robin  selectable  List.  The 
ADD  button  will  only  add  a  text  string  to  the  list  if  the  string  contains  a  character 
other  than  the  space  character  or  the  null  character. 


60.4.8.10  DEL  BUTTON 


The  DEL  key  deletes  the  selected  CALL  SIGN  or  GROUP  NAME  hrom  the 
ADDRESS  LIST. 


60.4.9  CEOI/GROUP  LIST  EDIT 


The  GROUP  LIST  is  the  list  containing  the  individual  CEOI  or  CALL  SIGN  of 
the  operator,  plus  up  to  7  GROUP  NAMES  for  groups  of  which  the  operator  is  a 
member  (both  are  8  character  alphanumeric  strings). 
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60.4.9.1  MESSAGE  RECEFTION 


The  station  will  receive  messages  addressed  to  the  CALL  SIGN  of  the  station  and 
messages  sent  to  groups  to  which  the  operator  claims  membership. 


60.4.9.2  EDITING  THE  LIST 

This  screen  allows  the  operator  to  edit  the  list  of  CALL  SIGNS  and  GROUP 
NAMES  for  messages  he  or  she  wishes  to  receive. 

60.4.9.3  FUNCTIONAL  DESCRIPTION 


This  screen  is  functionally  identical  to  the  ADDRESS  LIST  EDIT  menu,  except 
that  it  manages  a  separate  list  of  names. 


60.4.10  LOCATION  LIST  EDIT 

The  LOCATION  LIST  is  the  list  containing  alphanumeric  codes  of  up  to  8 
characters  for  up  to  8  battlefield  locations  for  use  in  the  MOVCMD  report. 


60.4.10.1  FUNCTIONAL  DESCRIPTION 


This  saeen  is  functionally  identical  to  the  ADDRESS  LIST  EDIT  menu,  except 
that  it  manages  a  separate  list  of  names. 


60.4.11  SYS  MAIN 


60.4.11.1  NEW  MESSAGE  Indicator 


When  the  DMCC  receives  a  new  message,  an  alert  box  will  pop  up  on  the  screen 
and  will  aimounce  the  type,  sender  and  priority  of  the  incoming  message.  The 
warnings  will  be  different  depending  on  the  priority  of  the  message.  The  alert 
box  will  be  dismissed  by  the  operator  by  clicking  a  box  in  the  alert  labelled 
DISMISS.  The  MESGS  indicator  will  show  tite  number  of  messages  (that  have 
not  been  read)  in  the  IN-BOX ,  the  type  of  message  just  received  (according  the 
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table  immediately  below  this  paragraph)  and  its  priority  (U  for  Urgent,  R  for 
Routine).  The  MESGS  indicator  is  the  number  which  appears  in  the  envelope. 


Receive  Message  Types 

Message 

Identifier 

SPOT 

SPT 

STATUS 

STA 

MOVBMBMT 

MVT 

BOA 

BOA 

LZ/PZ  RBCOM 

LZR 

AIR  ROUTS  RSCOM 

ARR 

OROUMD  ROUTS  RSCON 

ORR 

BP/OP  RSCON 

BPR 

CROSSING  RSCON 

CRR 

BRZD6S  RSCON 

BRR 

PRES  TEXT 

FTX 

ARTY  REPEAT 

ARP 

ARTY  CANCEL 

ACL 

ARTY  CHECK 

ACH 

ARTY  CNO 

ACN 

ARTY  SHIFT 

ASH 

ARTY  NEW  MSN 

ANM 

ARTY  END  MSN 

ABM 

REQUEST  REPORT 

RQR 

NBC 

NBC 

SPLASH 

SPS 

MZJZ 

MZJ 

NBC 

NBC 

PZREP 

PRP 

DNAV 

DNV 

60.4.11,2  SYS  MAIN  TMI  BUTTONS 


The  SYS  MAIN  menu  will  have  TMI  buttons  to  transfer  control  to  the 
ADDRESS  LIST  screen  and  the  CEOI/GROUP  LIST  screen.  It  will  have  a  soft 
bezel  to  transfer  control  to  the  SYS  MAIN  MSG  screen. 

It  will  also  contain  a  button  to  LOGOFF. 
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60.5  SYS  MAIN  MSGl  Window 

When  the  DMCC  operator  wants  to  read  a  message  he  or  she  has  just  received,  or 
dispose  of  a  message  he  or  she  has  just  read,  or  do  soihething  with  a  message  he 
or  she  received  some  time  ago  and  had  kept,  the  operator  will  start  with  the 
MESSAGES  MAIN  MENU. 


60.5.1  THE  IN-BOX 

A  numbered  list  of  all  the  messages  in  the  IN-BOX  shall  be  displayed,  with  the 
message  type,  the  sender,  the  time  the  message  was  sent,  and  ttve  priority  given 
for  each  message.  The  list  shall  be  arranged  ^t  by  priority  and  second  by  time 
of  message  receipt,  with  the  most  urgent  messages  appearing  in  a  group  at  the 
top  of  the  list.  Urgent  messages  shall  be  marked  with  a  U,  while  routine  priority 
messages  shall  be  marked  with  an  R.  Message  priority  shall  be  determined  by 
the  sender  of  the  message.  Upon  entering  the  MESSAGES  main  menu,  the  top 
message  in  the  list  shall  be  hig^ghted. 


60.5.2  ENVELOPE  ICON 

There  shall  be  an  ENVELOPE  ICON  at  the  bottom  of  the  simulated  SMD 
window  that  contains  the  MSGS  indicator  which  indicates  the  number  of  new 
messages  that  have  not  been  read.  This  icon  shall  appear  when  a  new  message 
is  received  by  the  DMCC.  When  a  message  has  been  read  but  has  not  been 
disposed  of,  it  shall  still  exist  as  an  active  message  in  the  IN-BOX  but  will  not  be 
reflected  in  the  number  on  the  envelope. 


60.5.3  MSG  READ 

Pressing  READ  shall  change  the  window  from  the  list  of  available  messages  to 
the  display  of  the  contents  of  the  highlighted  message  in  the  Sys  Main  Mesg  Read 
screen.  When  READ  is  ON,  a  second  press  of  the  READ  button  will  dismiss  the 
contents  and  return  to  the  list  of  messages  available.  This  option  shall  only  be 
available  if  messages  are  available  to  be  acted  upon.  The  second  line  of  the  CIK 
shall  be  blank  until  READ  is  on  at  which  time  the  second  line  shall  read  "ON". 


60.5.4  Message  Display  Formats 

Display  formats  for  the  information  contained  in  the  various  reports  are  textual 
information,  displayed  in  the  SYS  MAIN  MSG  READ  submenu.  They  are 
found  at  the  end  of  this  document. 
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60.5.5  PRE  MSG  and  NEXT  MSG  Bezels 


If  the  operator  decides  to  read  a  message  in  the  IN  BOX,  he  or  she  will  use  the 
PRE  MSG  and  the  NEXT  MSG  bezels  to  move  the  highlight  onto  the  desired 
message,  then  will  press  READ  MSG.  Upon  entering  the  READ  MSG  function 
the  contents  of  the  message  highlighted  on  the  MESSAGES  main  menu  are 
displayed  on  the  screen. 


60.5.6  DELETE  MSG  TMI 


Pressing  the  DELETE  MSG  TMI  shall  delete  a  message  from  the  IN*BOX .  This 
option  shall  only  be  available  if  messages  are  available  to  be  acted  upon. 


60.5.7  SAVE  &  EXIT 


The  SAVE  &  EXIT  switch  shall  save  any  changes  made  whUe  in  the  MSG  menu 
and  shall  return  control  to  the  SYS  MAIN  menu. 


60.5.8  RE-USE 


Pressing  the  RE-USE  TMI  shall  allow  the  operator  to  forward  the  same  message 
to  someone  else.  Control  will  transfer  to  the  REPORTS  menu,  from  where  a  new 
message  may  be  appended  to  the  original  message. 


60.5.9  REPLY 


When  a  message  is  selected  from  the  MAILBOX,  a  REPLY  TMI  will  become 
active.  This  switch  will  allow  the  operator  to  tranfer  to  the  REPORTS  menu, 
where  he  will  be  able  to  generate  a  new  message  of  preformatted  or  free-text 
type,  to  be  sent  to  the  sender  of  the  original  message.  The  ADRS  bezel  will 
already  have  selected  the  sender  of  the  first  message  as  the  addressee  of  the  new 
message  to  be  sent  back. 
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60.5.10  PREV,  NEXT 


Pressing  the  PREV  bezel  and  the  NEXT  bezel  shall  move  the  highlight  up  and 
down  t^  list  of  messages  in  the  IN-BOX  to  select  a  message  on  wUch  to  perform 
some  action.  The  highlight  shall  jump  to  the  top  message  when  die  NEXT  bezel 
is  pressed  and  the  highlight  is  on  the  bottom  most  message.  Likewise,  when  the 
topmost  message  is  highlighted  and  the  PREV  bezel  is  pressed,  the  highlight 
shall  move  to  the  bottom-most  item  on  the  list.  This  option  shall  only  be 
available  if  messages  are  available  to  be  acted  upon. 


Page  578 


Document  ADST/ WDL/TR-93-003036 


March  31, 1993 


60.6  RPRT  Windows 


The  RPRT  MENU  is  the  master  menu  for  sending  messages  (called  REPORTS) 
from  the  DMCC  to  the  other  DMC-capable  simulation  entities  in  the  AIRNET 
simulation  facility  or  elsewhere  in  t^  network.  The  following  paragraphs 
describe  the  various  widgets  in  this  menu  and  their  uses  and  effects. 


60.6.1  SAVE  6c  EXIT 


This  switch  shall  save  any  changes  made  while  in  the  RPRT  MENU  and  shall 
return  to  the  SYS  MAIN  MENU  or  whatever  function  was  being  used  when 
RPRT  was  invoked. 


60.6.2  SHOT 


Up>on  selection  of  this  switch,  the  system  shall  display  the  SHOT  TMI's  and 
SMDpage.  (see  below). 

60.6.3  SPLASH 


Upon  selection  of  this  switch,  the  system  shall  display  the  SPLASH  TMIs  and 
SMD  page  (see  below). 


60.6.4  MTO 

Upon  selection  of  this  switch,  the  system  shall  display  the  MTO  TMIs  and  SMD 
page  (see  below). 


60.6.5  SPOT 


The  SPOT  report  is  implemented  in  tlw  DMCC  even  though  no  grouitd  person  is 
anticipated  to  want  to  send  a  SPOT  report.  This  is  to  allow  the  assessment  of  the 
DMCC  archetecture  for  in>cab  simulated  communications,  and  to  provide  a 
simple  means  of  integration  testing.  Upon  selection  of  this  switch,  the  system 
shall  display  the  SPOT  TMIs  and  SMD  page  (see  below). 
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60.6.6  MOVCMD 

Upon  selection  of  this  switch  the  DMCC  shall  display  the  MOVCMD  TMIs  and 
the  MOVCMD  SMD  page. 

60.6.7  REQT 

Upon  selection  of  this  REQUEST  switch  the  DMCC  shall  display  the  RPRT 
REQT  TMIs  and  the  REQT  SMD  page. 

60.6.8  FREE  TXT 

Upon  selection  of  this  switch  the  DMCC  shall  display  the  RPRT  FREE  TXT  TMIs 
and  the  FREE  TXT  SMD  page. 
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60.7  RPRT  Window  Functionality 

The  following  sections  detail  the  screens  which  are  used  to  send  messages  from 
the  DMCC.  Each  screen  shares  the  following  features: 

60.7.1  COMMON  RPRTS  WINDOW  FUNCTIONS 

60.7.1.1  ADRS 


Once  the  screen  function  is  entered,  the  DMCC  operator  shall  select  an  addressee 
using  the  ADRS  soft  bezel  and  the  MORE  bezel.  This  will  take  the  form  of  a 
tape  type  list  of  6  possible  addressees.  The  addressees  will  be  listed  in  boxes  on 
this  tape,  and  the  operator  will  use  the  ADRS  key  to  cycle  a  highlight  aloi^  dus 
tape.,  wiht  the  highlight  round  robining  to  the  beginning  when  the  key  is  pressed 
while  the  highlight  is  at  the  end.  The  MORE  key  will  be  used  to  display  the 
remaining  addressees  if  there  are  more  than  6,  and  will  also  be  used  to  go  back  to 
the  first  set  of  selections  when  the  reihaining  ones  are  being  displayed. 


60.7.1.2  TAPE  WIDGET 


This  round-robin  tape  widget  will  be  used  to  perform  screen  specific  choices  also, 
as  outlined  below. 


60.7.1  J  TEXT  MSG 


Pressing  the  TEXT  MSG  TMI  shall  allow  the  DMCC  operator  to  add  any 
comments  to  the  report,  by  entering  it  on  the  KEYBOARD  and  pressing  the 
KEYBOARD  RETURN  key  or  clicking  on  the  ENTER  key  in  the  OK.  If  no  text 
message  is  entered,  the  text  message  display  area  of  the  screen  shall  remain 
blank. 


60.7.1.4  SEND  ROUTIN 

The  SEND  ROUTIN  TMI  shall  operate  as  described  in  the  SPOT  REPORT 
section. 
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60.7.1.5  SEND  URGENT 

The  SEND  URGENT  TMl  shaU  operate  as  described  in  the  SPOT  REPORT 
section. 


60.7.1.6  CLR  &  RETURN 

The  CLR  6c  RETURN  TMI  shall  terminate  the  report  function  without  saving 
any  changes  made  and  the  display  shall  return  to  die  SYS  MAIN  RPRT  mentL 


60.7.1.7  SAVE  6c  RETURN 


Pressing  the  SAVE  6c  RETURN  shall  save  any  changes  made  while  in  dw  current 
function  and  the  display  shall  return  to  the  RPRT  menu. 

60.7.1.8  ENUMERATED  TYPES  DEFAULT  VALUE 


If  a  selection  is  not  made  for  any  of  the  s^ecdon  fields  in  any  of  die  reports,  dien 
no  highlight  will  appear  on  the  SMD.  (In  this  case,  enumerated  type  0  for  diat 
type  will  be  transmitted,  meaning  NOT  ENTERED.  In  die  case  where  a  message 
is  received  containing  NOT  ENTERED  for  a  field,  the  message  read  display  for 
that  field  shall  be  bla^ 


60.7 J.  SPOT  REPORT 


The  SPOT  menu  will  have  round-robin  highlight  menu  dicnces  for  the  following: 

ENEMY  TYPE  (ADA,  SAM,  TANK,  WHLD,  TRKD,  ACFT,  TRPS,  UNCL) 

ENEMY  ACTIVITY  (STATIONARY,  MOVING,  DUG-IN,  RETREATING, 
ATTACKING  DMGD,  KRLED,  MOBIL.KILL); 

DIRECTION  (N,  NE,  E,  SE,  S,  SW,  W,  NW); 

OBS INT  (CONT.MSN,  ENGA,  RTS  IHLD,  OBSV  TGT). 
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60.7uLl  Enemy  Speed 

Text  fields  for  entry  of  enemy  SPEED  (3  char)  and  UNIT  (8  char)  will  be 
provided. 


60.7.2^  Text  Msg  TMI 

The  TEXT  MSG  TMI  will  allow  text  to  be  entered  in  the  23  character  CIK  test 
widget  for  editing  free  text  to  be  included  within  the  message. 


60.7.23  MPH/KPH  Switch 
A  TMI  toggle  switch  shall  select  between  MPH  and  KPH. 


60.7.2.4  Enemy  Type 

Each  time  the  ENEMY  TYPE  button  is  pressed,  the  GUI  software  will  make  a  call 
to  the  Date  Time  Group  routine  and  record  the  DTG.  This  DTG  represents  the 
EFFECTIVE  TIME  or  TIME  SIGHTED,  and  will  be  passed  as  an  argument  to 
the  to  the  SPOT  PDU  BUILDER  when  SEND  occurs. 


60.73.5  Enemy  Number 

A  3  character  decimal  integer  field  shall  be  provided  for  entering  the  NUMBER 
of  the  enemy. 


60.73.6  Enemy  Location 

The  lower  QK  text  widget  shall  be  labeled  LOCN  and  will  be  used  for  entry  of  a 
UTM  coordinate  of  up  to  16  alphanumeric  characters. 


60.7.3  MTO 


The  MTO  menu  has  three  TMIs  to  select  pre-formatted  messages  for 
transmission. 
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60.7.3.1  REQ  ADJ 

The  REQ  ADJ  TMI  will  Mltct  a  REQUEST  ADjl^ST  mtMaga  for  tianafliiMion. 

60.7.3.2  EAT 

The  EAT?  TMI  will  select  an  ENTER  AS  TARGET?  message  for  transmission. 
60.7.33  EOM 

The  EOM?  TMI  will  select  an  END  OF  MISSION?  message  for  transmission. 

60.7.3.4  TEXT  MSG 

The  TEXT  MSG  TMI  shall  operate  as  described  in  the  SPOT  REPORT  section. 

60.7.4  SHOT 


The  SHOT  report  menu  involves  no  buttons,  odter  than  die  staiulard  ones  which 
all  message  screens  use  as  described  above.  It  sends  the  SHOT  message  and 
then  displays  the  words  SHOT  REPORT  SENT  for  2  secoruls  in  a  small  pop  up 
window,  arid  returns  to  the  callmg  menu. 


60.7.5  SPLASH 

The  SPLASH  report  menu  sends  the  SPLASH  message  and  then  displays  the 
words  SPLASH  REPORT  SENT  for  2  seconds  in  a  pop  up  window,  and  returns 
to  the  calling  menu. 
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60.7.6  MOVCMD 


The  Comanche  Movement  report  shall  be  used  to  direct  units  to  a  particular 
location  to  perform  a  particular  activity,  or  to  inform  others  of  one's  intent  to 
move  somewhere.  It  is  intended  to  replace  the  traditional  verbal  or  written 
FRAGO  (Fragmentary  Order)  which  has  been  used  to  convey  timely  changes  to 
missions  which  were  previously  outlined  in  OPORDs  (Operational  Orders).  The 
MOVCMD  rejtoit  shkl  also  be  used  to  hand  over  targets  to  a  team  member  for 
servicing  when  speedy  message  compositicm  is  not  a  factor. 


60.7.6.1  TASK 


The  operator  DMCC  shall  select  in  a  tape  widget  the  desired  movement  task 
using  the  TASK  soft  bezel  and  the  MORE  bezel  exactly  as  prescribed  for 
selecting  an  addressee.  The  options  tmder  TASK  shall  include  "MOV  TO", 
"HOLD  AT",  "CONT  MSN",  "RENDZ  AT’,  "ENGAGE  TGT  AT’,  "MVNG  TO", 
"HLDNG  AT',  "ARVING  AT,  "PSNG  ’mRU",  and  "DPRTNG  FROM". 


60.7.6.2  When 


Pressing  the  WHEN  bezel  shall  round>robin  a  highlight  among  the  options  given 
for  when  the  movement  will  take  place.  Options  shall  include  "IMMED", 
"WHEN  RDY",  "AMC",  and  "TIME".  When  the  highlight  is  in  moved  to  the  last 
option,  "TIME",  the  alphanumeric  KEYBOARD  sh^  be  enabled  for  text  input  of 
a  time.  The  time  is  entered  in  die  form 

hhrmmL 

or 

hh:mm  Z. 

L  stands  for  Local  Time  and  Z  stands  for  Zulu,  or  Greenwich  Mean  Time,  the 
time  at  the  Prime  Meridian  in  Greenwich,  England. 

The  simulated  CIK  shall  display  the  prompt  TIME?"  on  the  Erst  line,  with  the 
operator  entering  the  time  on  the  second  lire. 

If  the  operator  entered  the  time  in  Local  Time,  the  DMCC  must  change  the  time 
to  ZULU  time  prior  to  transmissioiL  This  is  done  by  accessing  a  rile  containing 
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the  ZULU  OFFSET,  which  is  the  number  of  minutes  Local  Time  is  AHEAD  of 
ZULU  time.  This  file  is  changed  whenever  the  timezone  of  the  DMCC  changes. 


60.7.63  Location 


Pressing  the  LOCN  bezel  shall  round-robin  a  highlight  aonong  the  options  given 
for  where  the  movement  will  take  place.  Optioiu  sh^  include  "MY  POSN" ,  and 
those  positions  entered  in  the  location  list  e^t  screen. 


60.7.7  REQT  REPORT 


The  REQUEST  REPORT  function  shall  be  used  when  the  DMCC  operator  wants  to 
ask  another  DMC  entity  to  send  him  a  specific  kind  of  report.  Figure  6.6.5.22 
outlines  the  REQT  REFT. 


60.7.7.1  Report  Type  Selection 


A  round  robin  horizontal  tape  selection  of  the  type  of  report  to  be  requested  shall 
be  presented.  The  options  shall  include 

NONE 

STATUS 

SPOT 

RECON 

MOVEMENT 

PIREP 

MQI 


60.7.73  Recon  Type  Selection 

When  the  Recon  report  type  is  selected,  another  horzontal  tape  selection  for  the 
type  of  recon  report  desir^.  The  options  shall  include: 

GNDRTE 

AIRRTE 

BRDG 

LZ/PZ 

BP/OP 

CRSG 
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60.7.8  FREE  TEXT 


The  FREE  Text  message  window  will  basically  be  a  256  character  editable  text 
widget. 
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60.8  Message  Display  Formats 

Note:  These  drawings  provide  row  and  column  numbers  which  are 
not  displayed  on  the  actual  message  read  window.  Dots  are  also 
not  displayed;  they  are  provided  here  for  clarity  of  character 
position. 

SPOT  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .SPOT  MESSAGE . *URGENT* . 

1  . 

2  .SENDER . XXXXXXXX . 

3  .SENT  TO . XXXXXXXX . 

4  .FWD  BY . XXXXXXXX . 

5  .MSG  SENT . 26  1745  JDN  95.. 

6  .XMIT  LCN . NB  0624  0332 _ 

7  .X^IT  ALT . 12000  FEET . 

8  . . . 

?  .GT  QUAN . nntm . 

1(  .  '<31  TYPE . TRKD . 

11  .TGT  ACTIV . MVNG . 

12  .TGT  SPEED . 20  MPH . 

13  .TGT  DIRN . NW . 

14  .TGT  UNIT . aaaaaaaaaaaaaaaa 

15  .TGT  LCN . NB  2322  2323 _ 

16  .TIME  TGT  SGHTD _ 26  1744  JUN  95.. 

17  .OBS  LCN  AT  CNTCT. .NB  1233  4333.. 

18  .OBS  INTENT . EN6A . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 
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PREB  TEXT  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .FREE  TEXT  MESSAGE . ROUTINE . 

1  . 

2  .SENDER . XXXXXXXX . 

3  .SENT  TO . XXXXXXXX . 

4  .FWD  BY . XXXXXXXX . 

5  .MSG  SENT . 26  1745  JON  95.. 

6  .XMIT  LCN . NB  0624  0332 - 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  ... aaaaaaaaaaaaaaaaaaaaaaaaaa . 

10  . . . aaaaaaaaaaaaaaaaaaaaaaaaaa . 

11  . . .aaaaaaaaaaaaaaaaaaaaaaaaaa . 

12  . . .aaaaaaaaaaaaaaaaaaaaaaaaaa . 

13  ...aaaaaaaaaaaaaaaaaaaaaaaaaa . 

14  ... aaaaaaaaaaaaaaaaaaaaaaaaaa . 

15  . . .aaaaaaaaaaaaaaaaaaaaaaaaaa . 

16  ...aaaaaaaaaaaaaaaaaaaaaaaaaa . 

17  . . .aaaaaaaaaaaaaaaaaaaaaaaaaa . 

18  ...aaaaaaaaaaaaaaaaaaaaaaaaaa . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 
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ARTILLERY  CANCEL  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .ARTY  CANCEL. RPRT. .ROUTINE . 

1  . 

2  .SENDER  . 

3  .SENT  TO. 

4  .FWD  BY. . 

5  .MSO  SENT 

6  .EMIT  LCN 

7  .EMIT  ALT 

8  . 

9  . 

10  . 

11  . 

12  . 

13  . CANCEL . 

14  . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEET  ANNOTATION* • • 


.EXEEXEXX . 

» EEiEEXEEE . 
k  E1C22C2CEE)E  • 

.26  1745  JUN  95.. 
.NB  0624  0332.... 
.1200  FEET . 
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ARTILLERY  REPEAT  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .ARTY  REPEAT  REPT.  .ROtTTINE . 

1  . 

2  .SENDER  . 

3  .SENT  TO. 

4  .FWD  BY. . 

5  .MSG  SENT 

6  .EMIT  LCN 

7  .EMIT  ALT 

8  . 

9  . 

10  . 

11  . 

12  . 

13  . REPEAT . 

14  . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEET  ANNOTATION* • • 


26  1745  JDN  95.. 
NB  0624  0332.... 
1200  FEET . 
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ARTILLERY  CHBCX  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .ARTY  CHECK  REPORT . ROUTZHS . 

1  . 

2  .SENDER  . 

3  .SENT  TO. 

4  .FWD  BY.. 

5  .MSO  SENT 

6  .EMIT  LCN 

7  .EMIT  ALT 

8  . 

9  . 

10  . 

11 . 

12  . 

13  . CHECK . 

14  . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • 


yyyyyrrT . 

EXEEEEEE . 

yyyyyyyy . 

26  1745  JDN  95.. 
NB  0624  0332.... 
1200  FEET . 
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ARTILLERY  CNO  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .ARTY  CNO  REPORT. . .ROUTINE . 

1  . 

2  .SENDER . TTrTTTTT . 

3  .SENT  TO . XYXXXXXT . 

4  .FWD  BY . XXXXXXXX . 

5  .MSO  SENT . 26  1745  JUN  95.. 

6  .XMIT  LCN . NB  0624  0332 _ 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  .MISSION  ID . AAAAAAAAAAAAAAAA 

10  .TARGET  ID . AAAAAAAAAAAAAAAA 

11  .MISSION  STATUS _ AAAAAAAAAAAAA.  .  . 

12  .FIRE  FOR  EFFECT... NO . 

13  . 

14  . 

15  . CAN  NOT  OBSERVE . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 
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ARTILLERY  SHIFT  REPORT 


0  12  3 

01234567890123456789012345678901234 


0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 


.ARTY  SHIFT  REPORT. ROUTIMB 


.SENDER . XiyXXIXY . 

.SENT  TO . IIIIIXXl . 

.FWD  BY . XXXXXXXX . 

.MSO  SENT . 26  1745  JDN  95.. 

.EMIT  LCN . NB  0624  0332.... 

.XMIT  ALT . 1200  FEET . 


.MISSION  ID . AAAAAAAAAAAAAAAA 

.MISSION  status! !!!aaaaaaaaaaaaa... 
.FIRE  FOR  EFFECT... NO . 


. SHIFT...... 

aaaaaajuuuuuIaaaa 


.FREE  TEXT  ANNOTATION* • • 
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ARTILLERY  NEW  MISSION  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .ARTY  NEW  MSN  RPRT.ROOTINE . 

1  . . 

2 

. SENDER  . 

.  TTTTTTTX . 

3 

.SENT  TO . 

TTTTTTTT . 

4 

.FWD  BY . 

TTTTTTTX . . 

5 

.MSO  SENT . 

..26  1745  JUN  95.. 

6 

.XMIT  LCN . 

..NB  0624  0332 _ 

7 

.XMIT  ALT . 

.  .1200  . 

8 

9 

...  *  *  NEW  ARTILLERY  MISSION  *  * . . . 

10 

11 

.MISSION  ID . 

. .AAAAAAAAAAAAAAAA 

2 

.TARGET  ID . 

. .AAAAAAAAAAAAAAAA 

^3 

.MISSION  STATUS.. 

.  .AAAAAAAAAAAAA. . . 

14 

.MISSION  TYPE.... 

..IMMBD  SUPPR . 

15 

.SHELL . 

16  .CONTROL . WR . 

17  .FUZB . TIME  DBLAY 

18  .TRRJ . LON . 

19  .FIRS  FOR  BFFBCT...YBS . 

20  .FRBB  TEXT  ANNOTATION* • • . 
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ARTILLERY  MBSSAOB  TO  OBSERVER  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .ARTY  MTO  REPORT. . .RODTZME . 

1  . 

2  .SENDER . XXIIIXXI . 

3  .SENT  TO . XXXXXXXX . 

4  .FWD  BY . XXXXXXXX . 

5  .MSO  SENT . 26  1745  JDN  95.. 

6  .XMIT  LCN . NB  0624  0332.... 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  .MISSION  ID . AAAAAAAAAAAAAAAA 

10  .TARGET  ID . AAAAAAAAAAAAAAAA 

11  .MISSION  STATUS.  ..  .AAAAAAAAAAAAA.  .  . 

12  . 

13  . MESSAGE  TO  OBSERVER . 

14  . 

15  .REQUEST  ADJUST. .. .YES . 

16  .ENTER  AS  TARGET. . .NO . 

17  .END  MISSION . NO . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 
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ARTILLBRY  SHOT  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .ARTY  SHOT  REPORT. .ROUTIMS . 

1  . 

2  .SENDER . IXIXXXII . 

3  .SENT  TO . XIXEXIIX . 

4  .FWD  BY . XXXIXXXI . 

5  .MSQ  SENT . 26  1745  JDN  95.. 

6  .XMIT  LCN . NB  0624  0332.... 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  .MISSION  ID . AAAAAAAAAAAAAAAA 

10  .TARGET  ID . AAAAAAAAAAAAAAAA 

11  .MISSION  STATUS _ AAAAAAAAAAAAA.  .  . 

12  . 

13  . 

14  . 

15  . *  *  SHOT  FIRED  *  * . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 
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ARTILLBRT  SPLASH  RBPORT 

0  12  3 

01234567890123456789012345678901234 

0  .ARTY  SPLASH  RPRT. .ROUTZHB . 

1  . 

2  .SENDER . XXXXXXXY . 

3  .SENT  TO . XXXXXXXX . 

4  .FWD  BY . XXXXXXXX . 

5  .MSO  SENT . 26  1745  JDN  95.. 

6  .XMIT  LCN . NB  0624  0332.... 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  .MISSION  ID . AAAAAAAAAAAAAAAA 

10  .TARGET  ID . AAAAAAAAAAAAAAAA 

11  .MISSION  STATUS. .. .AAAAAAAAAAAAA. . . 

12  . 

13  . 

14  . *  *  SPLASH  *  * . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION . 


Page  598 


Document  ADST/WDL/TR-93-003036 


March  31, 1993 


ARTILLERY  END  OF  mSSXON  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .ARTY  EOM  REPORT. . .ROUTIMB. . . 

1  . 

2  .SENDER . XXIXXXXX . 

3  .SENT  TO . XXXXXXXX . 

4  .FWD  BY . XXXXIXXI . 

5  .MSO  SENT . 26  1745  JXJN  95.. 

6  .XMZT  LCN . NB  0624  0332.... 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  .MISSION  ID . AAAAAAAAAAAAAAAA 

10  .TARGET  ID . AAAAAAAAAAAAAAAA 

11  .MISSION  STATUS _ AAAAAAAAAAAAA.  .  . 

12  . 

13  . *  *  END  OF  MISSION  *  * . 

14  . 

15  .DISPOSITION . BURNING . 

16  . RECORD  AS  TARGET • . NO 

17  .CASUALTIES . 3000 . 

18  .POINT  NUMBER . AAAAAAAAAAAAAAAA. 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 
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NUCLEAR,  BIOLOGICAL, 

CHEMICAL  TYPE  1  REPORT 

0  1 

2  3 

01234567890123456789012345678901234 

0 

1 

.NBC-1  REPORT _ 

.URGENT . 

2 

.SENDER  . 

. XXXXXTKX . 

3 

.SENT  TO . 

.XXXXXXXX . 

4 

.FWD  BY . 

5 

.MSG  SENT . 

.26  1745  JUN  95.. 

6 

.ZMIT  LCN . 

.NB  0624  0332 - 

7 

8 
9 

.XMIT  ALT . 

.1200  FEET . 

..... >>>>  NUCLEAR 

BtfAST  <<<<  -  * . 

10 

1 1  .  DESCRIPTION . INCRBASINO . 

12  .BURST  TYPE . SURFACE . 

13  .DELIVERED  BY . ROCKET . 

14  .CLOUD  HGHT  UNITS. .DEGREES . 

15  .CLOUD  HEIGHT . 35 . 

16  .CLOUD  DESCRIPTION. AARAAAAAAAAAAAAA 

17  .FLASH  TO  BANG . 55. SECONDS . 

18  .START  TIME . 26  1743  JUN  95.. 

19  .STOP  TIME . 26  1744  JUN  95.. 

20  .FREE  TEXT  ANNOTATION* •• . 
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NUCLEAR,  BIOLCX3ICAL,  CHEMICAL  TYPE  4  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .NBC-4  REPORT . URGENT . 

1  . 

2  .SENDER . XXXXXXXX . 

3  .SENT  TO . XXXXXXXX . 

4  .FWD  BY . XXXXXXXX . 

5  .MSG  SENT . 26  1745  JUM  95.. 

6  .XMIT  LCN . MB  0624  0332 _ 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  .*. CHEMICAL  OR  BIOLOGICAL  ATTACK.*. 

10. . . 

11  .  DESCRIPTION . INCREASING . 

12  .BURST  TYPE . SURFACE . 

13  .DELIVERED  BY . ROCKET . 

14  .CLOUD  HGHT  UNITS .. DEGREES . 

15  .CLOUD  HEIGHT . 35 . 

16  .CLOUD  DESCRIPTION. AAAAAAAAAAAAAAAA 

17  .DOSE  RATE _ ...300 . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 
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NUCLEAR,  BIOLOGICAL,  CHEMICAL  TYPE  5  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .NBC- 5  REPORT . ROUTINE . 

1  . 

2  .SENDER . XXXXXXXX . 

3  .SENT  TO . XXXXXXXX . 

4  .FWD  BY . XXXXXXXX . 

5  .MSG  SENT . 26  1745  JUN  95.. 

6  .XMIT  LCN . NB  0624  0332 _ 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  . 

10  . 

11  . 

12  . 

13  . NBC  NEGATIVE . 

14  . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 
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STATUS  REPORT 


0  12  3 

01234567890123456789012345678901234 


0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 


.STATUS  REPORT . ROUTINE 


SENDER  . 

SENT  TO . 

FWD  BY . 

MSG  SENT . 

EMIT  LCN . 

EMIT  ALT . 

TfWTVTVy 

. . .XXEXXXXX . 

.  . .26  1745  JUN  95. . 

...NB  0624  0332 _ 

...1200  FEET . 

FUEL . 

FAILED  EQUPT. . . 
FAILED  EQUPT... 
FAILED  EQUPT. . . 

HELLFIRES . 

STINGERS . 

.  .  .EEMCE  LBS . 

. . . aaaaaaaaaaaaaaaa 
. . . aaaaaaaaaaaaaaaa 
. . . aaaaaaaaaaaaaaaa 

•  •  • XX •••••••••••••• 

VY 

rockets . 

ROUNDS . 

REQUEST  TYPE... 

. . .EXXX . 

.  . .AUTOMATIC . 

.FREE  TEXT  ANNOTATION* • • 
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REQUEST  REPORT:  STATUS,  SPOT,  MOVEMENT 

0  12  3 

01234567890123456789012345678901234 

0  .REQUEST  REPORT _ ROUTINE . 

1  . 

2  .SENDER . lEXXXXXX . 

3  .SENT  TO . XXXXXXXX . 

4  .FWD  BY . XXXXXXXX . 

5  .MSO  SENT . 26  1745  JUN  95.. 

6  .XMIT  LCN . NB  0624  0332.... 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  . REPORT  DESIRED .... STATUS . 

10  . 

11  . . 

12  . 

13  . 

14  . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 
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RBQOBST  REPORT:  RBCON 

0  12  3 

01234567890123456789012345678901234 

0  .REQUEST  REPORT _ ROUTINE . 

1  . 

2  . SENDER  . 

3  .SENT  TO. 

4  .FWD  BY.. 

5  .MSG  SENT 

6  .EMIT  LCN 

7  .EMIT  ALT 

8  . 

9  .REPORT  DESIRED _ RECON _ 

10  .TYPE  DESIRED . AIR  ROUTE 

11  . 

12  . 

13  . . 

14  . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  . FREE  TEET  ANNOTATION* •*.... 


EEEEEEEE . 

EEEEEEEE . 

EEEEEEEE . 

26  1745  JUN  95.. 
NB  0624  0332.... 
1200  FEET . 
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BATTLE  DAMAGE  ASSESSMEMT  REPORT 

0  12  3 

01234567890123456789012345678901234 


0 

1 

2 

3 

4 

5 
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7 

8 
9 

10 

11 

12 

13 

14 

15 

16 


17 


18 


19 

20 


.BDA  REPORT . RODTIliE 


.SENDER . XITXXXXX . 

.SENT  TO . IIXJIIXl . 

.FWD  BY . IXXIXXIl . 

.MSG  SENT . 26  1745  JDN  95.. 

.XMIT  LCN . NB  0624  0332 _ 

.XMIT  ALT . 1200  FEET . 


.STRIKE  START . 26  1740  JDN  95.. 

.STRIKE  END . 26  1742  JDN  95.. 

.TARGET  CATEGORY . 

.TARGET  TYPE . .TANK . 

.  TARGETS  DESTRYD ... 4 . 

.PERCENT  COVERAGE. .100 . 


.FREE  TEXT  ANNOTATION* • • 
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GROUND  ROUTS  RBCON  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .GND  RTS  RBCON  RPT. ROUTINE . 

1  . 

2  .SENDER  . 

3  .SENT  TO. 

4  .FWD  BY. . 

5  .MSG  SENT 

6  .EMIT  LCN 

7  .EMIT  ALT 

8  . 

9  .ENEMY  ACTIVITY - ATTACKING . 

10  .CLSFCTN  FORMULA. . .MLC . 

11  .CLSFCTN  INFO . AAAAAAAAAAAAAAAA 

12  .ROUTE  ID . AAAAAAAAAAAAAAAA 

13  . 

14  . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEET  ANNOTATION* *• . 


EEEEEEEE . 

EEEEEEEE . 

XETEEEEE . 

26  1745  JUN  95.. 
NB  0624  0332.... 
1200  FEET . 
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AIR  ROUTB  RBCON  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .AIR  RTB  RBCON  RPT.ROUTZNB . 

1  . 

2  .SBNDBR . IXXXXBII . 

3  .SENT  TO . IIXXBIII . 

4  .FWD  BY . YXXXBllI . 

5  .MSO  SENT . 26  1745  JUM  95.. 

6  .EMIT  LCN . NB  0624  0332.... 

7  .EMIT  ALT . 1200  FEET . 

8  . 

9  .ENEMY  ACTIVITY.  ..  .ATTACKING . 

10  . 

11  .OBSTACLES . TREES . 

12  . 

13  .ROUTE  ID . AAAAAAAAAAAAAAAA 

14  . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TBET  ANNOTATION* • • . 
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BRIDOB  RBCON  REPORT 


0  1 

2  3 

01234567890123456789012345678901234 

0 

1 

.BRIDGE  RBCON 

RPT. .ROUTINE . 

2 

. SENDER  . 

3 

.SENT  TO . 

4 

.FWD  BY . 

-  . .YyyyTTTT. ^  ^  ^  ... 

5 

.MSG  SENT . 

6 

.EMIT  LCN . 

7 

. XMIT  ALT . . . . . 

. 1200  FEET . 

8 

.BRIDGE  TYPE.. 

9 

.DAMAGE . 

10 

. SPANS . 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 


.CONST  MATL . MBTAL . 

.LENGTH . AAAA . 

.WIDTH . AAAX . 

.HEIGHT . AAAA . 

.UNDER . AAAA . 

.CONSTR  DBSCR . AAJIAAAAAAAAAAAAA 

ID . AAAAAAAAAAAAAAAA 

.SPAN  LENGTH . AAAA . 

.LOAD  CLASS . AAAA . 

.FREE  TEXT  ANNOTATION* • • . 
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LANDING  ZONE /PICKUP  ZONB  RBCON  RBPOKT 

0  12  3 

01234567890123456789012345678901234 

0  .LZ/PZ  RBCON  RPT.  .ROUTINB . 

1  . 

2  .SENDER  . 

3  .SENT  TO. 

4  .FWD  BY.. 

5  .MSG  SENT 

6  .XMIT  LCN 

7  .XMIT  ALT 

8  . 

9  .ACTIVITY  LIKELY. . .EXPECTED . 

10  .OBSTACLES . TNR/ANT . 

11  .OBST.  DESCR . AAAAAAAAAAAAAAAA 

12  .LZ/PZ  ID . AAAAAAAAAAAAAAAA 

13  .LZ/PZ  SIZE . AAAAAAAAAAAAAAAA 

14  . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 


26  1745  JUN  95.. 
NB  0624  0332.... 
1200  FEET . 
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BP /OP  RBCON  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .BP/OP  RECON  RPT. . .ROUTINE . 

1  . 

2  .SENDER  . 

3  .SENT  TO. 

4  .FWD  BY. . 

5  .MSG  SENT 

6  .EMIT  LCN 

7  .EMIT  ALT 

8  . 

9  .ENEMY  ACTIVITY _ EEPBCTED . 

10  .OBSTACLES . HIRES . 

11  .OBST.  DESCR . AAAAAAAAAAAAAAAA 

12  .BP/OP  ID . AAAAAAAAAAAAAAAA 

13  .BP/OP  SIZE . AAAAAAAAAAAAAAAA 

14  .AEIS . AAAAAAAAAAAAAAAA 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEET  ANNOTATION* • • . 


EEEEEEEE . ....... 

EEXXEEEE . 

EXTEEEEE . 

26  1745  JUN  95.. 
MB  0624  0332.... 
1200  FEET . 
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CROSSING  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .CROSSNO  RBCON  RPT. ROUTINE . 

1  . 

2  .SENDER . XXXXXXXX . 

3  .SENT  TO . riXXXXIX . 

4  .FWD  BY . TIXXXXXX . 

5  .MSG  SENT . 26  1745  JUN  95.. 

6  .XMIT  LCN . NB  0624  0332.... 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  .BANK  SLOPE  ENTRY. .AAAA . 

10  .BANK  SLOPE  EXIT. . .AAAA . 

11  .CROSSING  LENGTH. . .AAAA . 

12  .CROSSING  WIDTH _ AAAA . 

13  .CROSSING  DEPTH _ AAAA . 


14  .CURRENT  FLOW . AAAA.... 

15  .CROSSING  ID . AAAAAAAA 

16  . 

17  . 

18  . 

19  . 


20  .FREE  TEXT  ANNOTATION* • • 
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DOWNED  AIR  VEHICLE  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .DNAV  REPORT . URGENT . 

1  . 

2  .SENDER . XXXXXEXX . 

3  .SENT  TO . XXZZXXXZ.  ... _ 

4  .FWD  BY . XXXXXXXX . 

5  .MSG  SENT . 26  1745  JON  95.. 

6  .EMIT  LCN . NB  0624  0332 _ 

7  .EMIT  ALT . 1200  FEET . 

8  . 

9  .AIRCRAFT  TYPE . OH-58 . 

10  .AIRCRAFT  STATUS ... RECOVER . 

11  .PILOT  STATUS . GOOD . 

12  . 

13  . 

14  . 

15  . 


17  . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION* •• 
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Movement  Command  (MOVCMD)  RBPORT 

0  12  3 

01234567890123456789012345678901234 


0 
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8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 


.MOVCMD  REPORT, . . . .URGENT 


.SENDER . XXXXXXXX . 

.SENT  TO . XXXXXXXX . 

.FWD  BY . XXXXXXXX . 

.MSG  SENT . 26  1745  JUN  95.. 

.XMIT  LCN . NB  0624  0332.... 

.XMIT  ALT . 1200  FEET . 


.TARGET  ID . AAAAAAAAAAAAAAAA 

.TASK . CONT  MSN . 

.WHO . B3 . . . 

.WHEN . 1245  Z;  0445  L. . 

.WHERE . AAAAAAAA . 


.FREE  TEXT  ANNOTATION* • • 
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PIRBP  REPORT 


0  12  3 
0123456789012.3456789012345678901234 


0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 


.PILOT  REPORT . ROnTIEB 


.SENDER  . 

.xxxxxxxx . 

.SENT  TO . 

.xxxxxxxx . 

.FWD  BY . 

. xxxxzxxz . 

.MSG  SENT . 

.26  1745  JUN  95.. 

.EMIT  LCN . 

.NB  0624  0332 _ 

.EMIT  ALT . 

.1200  FEET . 

.VISIB..HALF  MILE. 

.BLIZZARD . 

.CLOS  SCTRO,  BASE 

12000,  TOP. 30000. 

.TEMP..  -5.C . 

.BAR  29.56" . 

.WIND  80  KNOTS,  NORTH  EAST . 

.CONT,  EXTREME  TURBULENCE . 

.SEVE^  CL^  ICING . 

.FREE  TEXT  ANNOTATION* • • 
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MIJI  REPORT 

0  12  3 

01234567890123456789012345678901234 

0  .MIJI  REPORT.  _ _ ROUTINE . 

1  .  . 

2  .SENDER . XXXXXXXX . 

3  .SENT  TO . XXXXXXXX . 

4  .FWD  BY . XXXXXXXX . 

5  .MSO  SENT . 26  1745  JUN  95.. 

6  .XMIT  LCN . NB  0624  0332.... 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  .AFFECTED  FREQ . XXX.XXXXXX  IcHz.. 

10  .PROGRAMD  FREQ . 1 ... XXX . xxxxxx  kHz.. 

11  .PROGRAMD  FREQ.2 .. .XXX.XXXXXX  kHz.. 

12  .PROGRAMD  FREQ. 3 . . .xxx.xxxxxx  kHz.. 

13  .PROGRAMD  FREQ . 4 ... xxx . xxxxxx  kHz.. 

14  .START  TIME . 26  1711  JUN  95.. 

15  .STOP  TIME . 26  1711  JUN  95.. 

1 6  .  DESCRIPTION . WARBLING . 

17  .PERCENT  LOST . XXX  PERCENT . 

18  .TYPE . JAMMING . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 

HOTS:  Frequencies  cone  in  as  64  bit  floating  point  nuinbers 
which  express  cycles  per  second  (Herts).  This  is  to  be 
changed  to  kiloHerts,  (kHs)  if  the  nunber  is  greater  than  or 
equal  to  1000  and  less  than  a  Bullion;  it  is  to  be  changed  to 
Megahertz  (MHz)  if  the  value  is  greater  than  or  equal  to  a 
million  and  less  than  a  billion;  and  it  is  to  be  changed  to 
GigaHertz  (GHz)  if  it  is  over  a  billion.  The  notations  Hz, 
kHz,  MHz,  and  GHz  (case  exactly  as  shown  here)  are  to  be 
used.  One  to  three  decimal  places  are  to  be  to  the  left  of 
the  decimal  point;  exactly  6  (with  right  filled  zeroes)  are 
to  be  to  the  right. 
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ACKNOWLBDQEKBMT 

0  12  3 

01234567890123456789012345678901234 

0  .acknowledgement. . .ROUTINE . 

1  . 

2  .SENDER . XXXXXXXX . 

3  .SENT  TO . XXXXXXXX . 

4  .FWD  BY . XXXXXXXX . 

5  .MSG  SENT . 26  1745  JUN  95.. 

6  .EMIT  LCN . NB  0624  0332.... 

7  .XMIT  ALT . 1200  FEET . 

8  . 

9  .YOUR  MESSAGE  TO. . .AAAAAAAA . 

10  .WAS  RECEIVED  AT. . .26  1743  JUN  95.. 

11  . . . 

12  . 

13  . 

14  . 

15  . 

16  . 

17  . 

18  . 

19  . 

20  .FREE  TEXT  ANNOTATION* • • . 
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70.  Appendix  G  -  Data  Flow  Diagrams. 

The  following  diagrams.contain  data  flow  diagrams  for  the  DMCC  System  and 
the  DMCC  X-Client  Process. 

70.1  Top  Level  DMCC  Inter-Process  Data  Flow  Diagram 


POU  FOR  YOU 


70.2  DMCC  X-Client  Process  Data  Flow  Diagram 
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